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Burroughs cannot accept any financial or other 
responsibilities that may be the result of your use 
of this information or software material, 
including direct, indirect, special or consequential 
damages. There are no warranties extended or 
granted by this document or software material. 



You should be very careful to ensure that the use of this 
software material and/or information complies with the 
laws, rules, and regulations of the jurisdictions with 
respect to which it is used. 



The information contained herein is subject to change 
without notice. Revisions may be issued to advise of 
such changes and/or additions. 



Comments or suggestions regarding this document should be submitted on 
a Field Communication Form (FCF) with the CLASS specified as 2 (S.SW: 
System Software), the Type specified as 3 (DOC), and the product specified 
as the 7-digit form number of the manual (for example, 1152055). 
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PREFACE 



lliis Burroughs B 1000 Systems Memory Dump Analysis Functional Description Manual describes tech- 
niques that a support person can use to locate the immediate and fundamental causes of system halts 
and system hangs, as well as certain performance problems. The manual provides a detailed description 
of the information contained in a system memory dump and a program memory dump and shows how 
to determine the state of the processor, the software, and the input/output operations at the time the 
system memory dump is taken. 

Following are summaries of the contents of each section of the manual. 

Section 1: System Memory Dump 

The various types of system halts and system hangs are defined. Also, procedures for dumping 
the state of the system into the SYSTEM/DUMPFILE file are described, GISMO debugging aids 
are explained, and the Fault Dockets, forms to be completed at the time of a system halt or hang, 
are exhibited. 

Section 2: The SYSTEM/IDA Program 

Explains how to produce a formatted analysis of the SYSTEM/DUMPFILE file using the Interac- 
tive Dump Analyzer (SYSTEM/IDA) program. 

Section 3: Operating System Components 

Lists the components of the operating system and describes the functions of each component. 

Section 4: Problem Analysis Overview 

Provides an overview of the steps required to analyze system halts and system hangs. 

Section 5: State of the Software 

Describes how to determine the status of each operating system component and each job in the 
mix. 

Section 6: State of the Input/Output Operations 

Describes how to determine the status of each input/output operation represented in the system 
memory dump. 

The appendixes cover the following topics: 

Appendix A: examples of SYSTEM/IDA program execution. 

Appendix B: hardware organization. 

Appendix C: control of processor allocation by GISMO. 

Appendix D: memory organization. 

Appendix E: memory management. 

Appendix F: input/output operations. 

Appendix G: disk organization. 

Appendix H: tape organization. 

Appendix I: RPG memory dumps. 
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The following B 1000 manuals contain information related to the topics in this manual. 
B 1000 Systems System Software Operation Guide, Vol. 1, form number 1169000. 
B 1000 Systems System Software Operation Guide. Vol. 2, form number 1169091. 
B 1870/B 1860 Systems Reference Manual, form number 1090644. 
B 1000 Series Product Support Information Manual, form number 1137890. 
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SECTION 1 
SYSTEM MEMORY DUMP 

If the B 1000 system halts or hangs, several actions may be taken to isolate, analyze, and solve the 
problem. In the paragraphs that follow, along with definitions of the various types of system halts 
and system hangs, the steps to be taken by the system operator on a halt or hang are given. Also 
in this section, Fault Dockets, forms to be completed at the time of a halt or hang, are exhibited, 
and procedures for performing a CLEAR/START system memory dump and for using the GISMO 
trace routine are outlined. 

SYSTEM HALT 

A system halt is indicated when a system running under MCP control stops performing work, and the 
RUN indicator goes off. There are two classes of system halts: software-controlled system halts and 
undefined system halts. 

Software-Controlled System Halt 

A system halt with the ERROR indicator off and a defined value in the L register is a software-control- 
led system halt. This type of halt may occur when an MCP component (GISMO, the Micro MCP, 
or the SDL2 Interpreter when running the SMCP) detects an invalid value in a data field or register, 
a condition in which further processing will result in data corruption or loss. When this happens, the 
contents of the L, T, X, and Y registers of the master processor) are written into the HINTS record 
in lower memory, and a HALT microinstruction is then executed. The L, T, X, and Y registers of 
the slave processor are written in a memory area allocated for the slave processor. 

Defined L register values are those with any of the following patterns in the sixteen leftmost bit posi- 
tions (bits 0-15) of the register. 

Pattern Routine or program that halted 

@0000@ SDL2 Interpreter on behalf of the MCP 

@0200@ Micro MCP 

@0D00@ GISMO 

@0D01(§ GISMO 

@00F0@ SYSTEM/INIT 

@000F@ CLEAR/START 

For more information on the use of the L register, refer to section 8 of the B 1000 Systems System 
Software Operation Guide, Volume 1. All relevant values for the 24-bit L register are listed there. 

When a software-controlled system halt occurs, the operator should take the following action: 

1. Fill in a Fault Docket. See Fault Dockets, later in this section. 

2. Perform a CLEAR/START operation with a system memory dump. (Exception: No dump is 
required if HALT occurred during CLEAR/START or SYSTEM/INIT as indicated by LC or 
LD = F.) The CLEAR/START program and memory dump procedure are described in detail 
in section 4 of the B 1000 Systems System Software Operation Guide, Volume 2. Also see 
CLEAR/START and System Memory Dump, later in this section. 

3. Package the system memory dump. 
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Undefined System Halt 

A system halt with an undefined value in the L register and the ERROR indicator either on or off 
is an undefined system halt. An undefined L register value is one that is not listed in section 8 of 
the B 1000 Systems System Software Operation Guide, Volume 1. 

The MCP components are designed to halt in a defined manner. An undefined system halt occurs when 
a processor or memory error leads to the execution of a HALT microinstruction. This may result from 
the transfer of processor control out of the defined instruction sequence, from the execution of one 
or more corrupted microinstructions, or from the detection of an irrecoverable hardware problem by 
the processor. 

When an undefined system halt occurs, the operator should take the following action: 

1. Fill in a Fault Docket. 

2. Perform a CLEAR/START operation with a system memory dump. 

3. Package the system memory dump. 
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SYSTEM HANG 

"Hang" is the name given to the condition in which a system running under MCP control does not 
respond to ODT commands even though the RUN indicator is on. If the system in this condition comes 
to a halt when the INTERRUPT button is pressed, an interruptible system hang has occurred. If the 
system does not halt when the INTERRUPT button is pressed but does halt when the HALT button 
is pressed, a non-interruptible system hang has occurred. If neither the INTERRUPT button nor the 
HALT button cause the system to halt, a processor hang has occurred. 

Interruptible and Non-lnterruptible Hangs 

In an interruptible system hang, an MCP component or a job of very high priority is in a loop, pre- 
venting jobs of lower priority from running. Once the hang is detected, the operator should wait at 
least 60 seconds before pressing the INTERRUPT button because the MCP may wait that long for 
some I/O operations to complete. 

If the INTERRUPT button has no effect, the condition may be a non-interruptible system hang or 
a processor hang. 

A non-interruptible hang occurs when a microcoded MCP component is in a microinstruction loop and 
is not leaving the loop to test for the interrupt. In this case, pressing the HALT pushbutton brings 
the system to a halt. 

If the HALT button has no effect, a processor hang condition exists. See Processor Hang. 
For an interruptible or non-interruptible hang, the operator should take the following action: 

1. Fill in a Fault Docket. 

2. If the system hang is reproducible, set up for a GISMO trace of the disk channel(s), OISMO, 
port, MMCP, SMCP, scheduler, interrupt.handler, and timer. interrupt (TG = @0041B8@ for 
a single disk channel on channel 9, @0061B8@ for disk channels 9 and 10), and perform the 
sequence leading up to the hang again. A full GISMO trace is rarely required. 

3. Perform a CLEAR/START operation with a system memory dump. 

4. Package the system memory dump. 
Processor Hang 

A processor hang has occurred when the system is hung and neither the INTERRUPT nor the HALT 
button brings the system to a halt. This type of hang is caused by a hardware malfunction. In this 
situation, the operator should perform the following steps: 

1. Push the HALT and CLEAR buttons at the same time. 

2. Perform a clear/start operation and resume processing if possible. 

3. Notify a Burroughs Field Engineer even if processing resumes. 

There is no need to fill in the Fault Docket, set up a full GISMO trace, or take a system memory 
dump. 
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FAULT DOCKETS 

Figure 1-1 shows the Fault Docket form for dual-processor systems, and figure 1-2 shows the form 
for single-processor systems. The forms are self-explanatory. Table 1-1 identifies the mdicators and reg- 
isters of interest. 

B 1000 Dual Processor Fault Docket 

OPERATOR: SYSTEM: DATE: TIME: 

In the event of a system halt or hang, please answer the 
following (circle the appropriate response): 

1. Are the RUN lights ON? 

Master: ON OFF Slave: ON OFF 

If both are OFF, then go to step 6. 

2 Enter the HALT system command. Are the RUN lights ON? 
Master: ON OFF Slave: ON OFF 
If both are OFF, then go to step 6. 

3. Press the INTERRUPT pushbutton. Are the RUN lights ON? 
Master: ON OFF Slave: ON OFF 
If both are OFF, then go to step 6. 

k. Press the HALT pushbutton. Are the RUN lights ON? 
Master: ON OFF Slave: ON OFF 
If both are OFF, then go to step fa. 

5. Press HALT and CLEAR. Call Field Engineer for assistance. 

6. Is the ERROR light on? 
Master: ON OFF Slave: ON OFF 

7. Is the STATE 1 ight on? 
Master: ON OFF Slave: ON OFF 

8. What are the values in the following registers? 

Master Slave 

L LR L LR 

T CC T CC 

X CD X CD 

Y PERM Y PERM 

A PERP A PERP 

FA FA 

9. Write the halt definition below: 
Master: 



Slave: 

10. Comments: 
Master: 



Figure 1-1. Fault Docket for Dual-Processor Systems 
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B 1000 Single Processor Fault Docket 

OPERATOR: SYSTEM: DATE: TIME; 

In the event of a system halt or hang, please answer the 
following (circle the appropriate response): 

1. Is the RUN light on? 

ON OFF 
If OFF, then go to step 6. 

2. Enter the HALT system command. Is the RUN light ON? 

ON OFF 
If OFF, then go to step 6. 

3. Press the INTERRUPT pushbutton. Is the RUN light ON? 

ON OFF 
If OFF, then go to step 6. 

if. Press the HALT pushbutton. Is the RUN light ON? 
ON OFF 
If OFF, then go to step 6. 

5. Press HALT and CLEAR. Call Field Engineer for assistance. 

6. Is the ERROR 1 ight on? 

ON OFF 

7. Is the STATE 1 ight on? 

ON OFF 

8. What are the values in the following registers? 

L LR 

T CC 

X CD 

Y PERM 

A PERP 
FA 

9. Write the halt definition below: 



10. Comments! 



Figure 1-2. Fault Docket for Single-Processor Systems 
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Indicators: 
Name 

STATE 

RUN 

ERROR 

Registers: 
Name 

L 

T 
X 
Y 
A 
FA 

LR 
CC 



CD 



PERM 



PERP 



Usage 



Indicates CC (0) is TRUE, used by system performance monitor. 
Indicates processor is running, as opposed to halted. 
Indicates one or more bits in PERM or PERP is TRUE. 



Usage 



for microinstructions 
absolute bit address 
field. 



used to access 



Working storage 
Working storage 
Working storage 
Working storage 
Address Register 
Field address, the 
a main memory data 
Limit Register 

« STATE light on console 

- Real time clock interrupt, set by hardware 
every 100 milliseconds 

■ I/O service request by one or more controls 
= INTERRUPT button on console pushed 

- M-register micro fetch parity error 
Cache Key parity error 
Cache double hit 
Console cassette parity error 
Uncorrectable S Memory parity error 
PERM register has changed 
S Memory field out of bounds 
S Memory microinstruction time out 

(1) - Memory Write/Swap out of bounds override 

(2) - Read out of bounds (FA < BR or FA > LR) 
CD (3) = Write or Swap out of bounds (FA < BR or FA 
Parity ERror Memory 

PERM(O) - S Memory microinstruction time out 
PERM(l) 




CD 
CD 



> LR) 



= Read, Write, or Swap out of memory (FA > MAXS) 

PERM(2) = Error Log register changed 

PERM (3) - Uncorrectable CPU access error to S Memory 

If it occurs during fetch, the processor halts. 
Parity ERror Processor 
PERP(O) = Cache double hit 
PERP(l) " Cache Key parity error 
PERP (2) = M Register parity error 
PERP (3) = Cassette read error 



Table 1-1. Indicators and Registers 
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CLEAR/START AND SYSTEM MEMORY DUMP 

After the Fault Docket form has been completed, a CLEAR/START operation with a system memory 
dump is called for on all halts and hangs. 

DUMP System Option 

The DUMP system option must be set if a CLEAR/START with a system memory dump is desired. 
If this option is reset, the SYSTEM/DUMPFILE file does not exist, its address in the COLD START 
VARIABLES i& zero, and, therefore, a system memory dump operation is not possible. As standard 
operating procedure, it is advisable to run with the DUMP system option always set. 

Memory Dump Details 

The system memory dump must be completed successfully in the first CLEAR/START operation fol- 
lowing the halt. This is because the first step in the process writes the entire contents of memory to 
the SYSTEM/DUMPFILE file on disk, and the second step (the CLEAR/START itself) clears 
memory, writing zeros and correct parity throughout. Thus, the state of the system when the problem 
occurred is no longer reflected in memory after a CLEAR/START operation. 

The contents of the SYSTEM/DUMPFILE file are valid only if the system is running under MCP con- 
trol at the time the system memory dump operation is performed. This process cannot be used for 
analyzing problems when the CLEAR/START, SYSTEM/INIT or STANDALONE programs are in 
control. 

A special situation may arise when a system appears to hang, for example, printers and tapes stop, 
but it still responds to system commands. It is acceptable, in this case, to enter a DM system command 
with no mix number to get a system memory dump. However, this action sometimes causes the actual 
problem data to be lost -the processing associated with reading, recognizing, and executing the DM 
system command rearranges memory and changes the state of the system. Either of the following pro- 
cedures avoids this problem: 

1. Interrupt the system and take a CLEAR/START system memory dump, thus preserving the ex- 
act state of the machine at the time of the hang. 

2. Run system performance monitoring to determine what the system is actually doing. System 
performance monitoring is described in appendix B of the B 1000 Systems System Software Op- 
eration Guide, Volume 1. 

Packaging the System Memory Dump 

If the analysis of the contents of the SYSTEM/DUMPFILE file is not to be performed immediately 
following the system memory dump operation, the current file must be packaged for later analysis. 
This is done by entering the PM system command to generate a packaged dump file with the default 
name of DUMPFILE/PM < nnn > , where <nnn> is the next number from the BACKUP stream. 

The packaged dump file includes the contents of the SYSTEM/DUMPFILE file plus layout tables for 
the SMCP, the network controller, and the DMS access routines. Object code segments from memory 
at the time of the system memory dump are compared with the corresponding object code files on 
disk, and code segment comparison error information is included in the packaged file. 

This packaged file is to be submitted with the Fault Docket and an FCF describing the problem. 
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GISMO TRACE 

The GISMO trace facility is a powerful and useful debugging tool. It can be used to pinpoint I/O 
subsystem failures, as well as to track down system software problems. Invoking the GISMO trace fa- 
cility incurs an overhead of 3 percent to 20 percent depending upon the functions being traced. 

The GISMO tracing code is in a discardable segment that may be requested at CLEAR/START time. 
If it is not requested, the segment is discarded. If either the BR register or the TG register is non- 
zero at CLEAR/START time, the segment is included. 

Setting the Trace Parameters 

The TG command is used to permanently specify the trace parameters normally entered in the BR regis- 
ter and results in the same action as would have occurred had the parameters been loaded manually 
into the BR register during a CLEAR/START operation. Trace parameters that are specified by means 
of the TG command are overridden if the BR register is non-zero at CLEAR/START time. 

Trace parameters that have been established during the CLEAR/START operation may be changed 
by means of the TG command; that is, a second CLEAR/START operation is not required to change 
the trace parameters. 

On B 1990 systems, the trace flags are entered at CLEAR/START time by the TEXT TG command, 
followed by six hexadecimal digits representing the trace flags. No @ symbols are used. On the other 
B 1000 systems, the trace flags are entered at CLEAR/START time by loading the BR register after 
the TAPE mode finishes but before RUN mode commences. The L register is equal to @AAAAAA@ 
at this point. 

The 24 bits comprising the trace parameters are defined in table 1-2. 
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Table 1-2. Trace Parameters 

Bits Function 

0-14 Trace physical I/O on the corresponding channel 

Dispatch through channel table 

Reference address, op code, and disk sector address 

Service request 

Reference address and result descriptor 

Extended result descriptor 

Data transfer (when bit 22 is also set) 

Pocket select 

Seek complete 

Missing device 

Bad reference address 

15 Trace GISMO scheduling and interrupt operations 

Block slave 

Unblock slave 

Block slave complete 

DCPU dispatch 

Set event for interrupt queue or I/O complete 

Save interrupt 

Fetch interrupt 

Communicate 

Rehang program 

Hang program 

Wait 

Cause program 

Set event index for waiting program 

Reinstate job 

Mark in queue 

Queue out top 

Adjust interpreter 

Communicate with GISMO 

Run MMCP 

MMCP page zero fault 

MMCP return 

16 Trace GISMO port activity 

Port dispatch 

Port interrupt 

Port lockout 

Port missing device 

17 Trace user interpreters (debug versions only) 
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Table 1-2. Trace Parameters (Cont) 
Bits Function 

18 Trace MMCP (must use MICRO-MCP/DEBUG) 

CONDITIONAL . HALTS 

Logical I/O 

Interprogram communication 

19 Trace SMCP CONDITIONAL. HALTS (sets bit 2 of SEGMENT__HALT) 

20 Trace GISMO scheduler and interrupt handler 

Lock scheduler 
Unlock scheduler 
Run scheduler 
Interrupt handler 
Timer interrupt 

21 Trace time stamp 

Include time stamp in trace table 

22 Trace data transfers for selected channel(s) 

23 Used internally by GISMO. 

To trace all the non-I/O functions, bits 15, 16, 18, 19, 20, and 21 must be turned on. Enter: 

TG @0001BC@ 
To trace only the disk channel, assumed to be located on channel 9, bit 9 must be turned on. Enter: 

TG @004000@ 
To display the settings of the trace flags, enter: 

TG 
To reset the trace flags, enter 

TG 

Tracing of data transfers uses up the trace table very quickly, and should not be used unless advised 
by Burroughs. 

Some of the Trace GISMO functions concerning processor allocation are described in appendix C. 
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Printing tlie Trace Table 

Printing of the GISMO trace table is part of the function of the analyzer (the SYSTEM/IDA program). 
Thus, a system memory dump is required to capture the trace table contents. The analyzer causes the 
table entries to be printed in a readable format. It combines multiple entries onto single print lines 
for ease of use, where applicable, and prints the trace table, maintained by GISMO in a "wrap-around" 
fashion, in chronological order with the most recent entries at the end of the printout. 

The output listing of the GISMO trace table produced by the analyzer contains four columns of infor- 
mation. Column contents are as follows: 

Column Identification Contents 

MASTER... SLAVE EVENT Name of the event traced 

An event on the slave is preceded by "..." 
CHANNEL Channel affected 

REF-ADDR Address of the I/O descriptor 

DESCRIPTION Further information and parameters 

INVOKING MICRO-MCP/DEBUG 

MICRO-MCP/DEBUG is the debug version of the Micro lyiCP. It is invoked by entering the following 
CM system commands and then performing a CLEAR/START operation. 

CM MMX MCPII/MICRO-MCP 
CM MM MICRO-MCP/DEBUG 

The debug version of the Micro MCP is placed into the standard Name Table entry. The non-debug 
version is placed into the experimental Name Table entry and is available for restoring the system to 
a non-debug state. 
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SECTION 2 
THE SYSTEM/IDA PROGRAM 

The Interactive Dump Analyzer (SYSTEM/IDA) program replaces the ISSA program and the 
DUMP/ANALYZER program. Neither of those programs is included in the Mark 12.0 B 1000 System 
software release. 

The SYSTEM/IDA program analyzes system memory dump files, program dump files, and programs 
within system memory dump files. 

The PM system command causes the SYSTEM/IDA program to transform the SYSTEM/DUMPFILE 
file into a packaged dump file that includes the contents of system memory, layout tables, and code 
segment comparison error inl'ormation. Layout tables contain the SDL2 data declarations used by 
SYSTEM/IDA to interpret the contents of memory. Packaging the SYSTEM/DUMPFILE file is essen- 
tial if later analysis or transmission of the file to another site for analysis is contemplated. Only SMCP, 
NDL, and DMS access routine layouts are added to the packaged dump file. 

Direct execution of the SYSTEM/IDA program allows interactive analysis of selected portions of a 
dump file. Direct execution also enables a formatted analysis of the entire dump file or portion of 
it to be printed. 

SYSTEM/IDA commands belong to two categories, control commands and object commands. The ob- 
ject commands may be further subdivided into two types: program object commands and system object 
commands. 

Control commands are active; in addition to returning information, they may be used to change the 
current job, current environment, current file, and so forth. Object commands are passive; they return 
information but have no influence on subsequent actions. 

Multiple commands separated by semicolons may be included in a single transmission. 
Example: 

GET SYSTEM/DUMPFILE; PRINT lOAT; PRINT CHANNELS; PRINT DISK 

All commands are described under the headings Control Commands, Program Object Commands, and 
System Object Commands in this section. 
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USING SYSTEM/IDA 

The SYSTEM/IDA program may be initiated from a remote terminal as well as from the ODT. 
Initiation from a Remote Terminal 

There are three ways to initiate a run of the SYSTEM/IDA program from a remote terminal: (1) 
EXECUTE, a program control instruction, (2) PASS, an SMCS command, or (3) ON, an SMCS com- 
mand. 

Using EXECUTE 

The user transmits EXECUTE (or EX), receives the BOJ, REMOTE FILE OPENED, and Welcome 
messages, transmits a GET command, and receives the output from the GET command. 

Example: 

EX SYSTEM/ 1 DA 

SYSTEM/IDA =1900 BOJ. PP=k, MP=4 TIME =13:19:31-7 

REMOTE FILE OPENED BY "SYSTEM/ 1 DA" , SIGNAL = * 

— Ready for INPUT (type HELP for help) — 
GET SYSTEM/DUMPF I LE 

[output resulting from entry of GET command] 

Using PASS 

The PASS command may be used if the SYSTEM/IDA program has been entered in the SMCS Jobs 
file. The user transmits the PASS command with a GET command appended. A MESSAGE QUEUED 
message followed by the output from the GET command is received. 

Example: 

PASS SYSTEM/ 1 DA GET SYSTEM/DUMPF I LE 

MESSAGE QUEUED FOR "SYSTEM/IDA": WAITING OPEN 
[Output resulting from entry of GET command] 

Using ON 

The ON command may be used if the SYSTEM/IDA program has been entered in the SMCS Jobs 
file. The user transmits the ON command with a GET command appended. A Welcome to the 
SYSTEM/IDA program message followed by the output from the GET command is received. 

Example: 

ON SYSTEM/ 1 DA GET SYSTEM/DUMPF I LE 
~ Welcome to SYSTEM/ 1 DA — 
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Initiation from the ODT 

There are three ways to run the SYSTEM/IDA program from the ODT. One way is by entry of the 
PM system command. The other two ways are two different modes of using the EXECUTE program 
control instruction. 

Using PM 

The user transmits a PM command with a FILE program control instruction appended, directing the 
packaged dump file to a user disk. 

Example: 

PM; FILE PM NAME PACKX/PACKAGE/DUMPF I LE 

Using EXECUTE 

There are two ways of using the EXECUTE program control instruction from the ODT. 

1. The user transmits an EXECUTE (EX) command with a FILE program control instruction to 
rename the DUMPFILE file as the previously packaged system dump file. An AC program con- 
trol instruction containing a pair of SYSTEM/IDA program control commands is included to 
print the disk descriptor chain and then terminate. 

Example: 

EX SYSTEM/IDA; FILE DUMPFILE NAME PACKX/PACKAGE/DUMPF I LE; 
AC PRINT DISK;BYE 

2. The user transmits an EX command and receives a BOJ and a Welcome to SYSTEM/IDA mes- 
sage. The SYSTEM/IDA program waits for transmission of an AC or AX system command 
containing an SYSTEM/IDA command and then displays the requested information. 



Example: 



EX SYSTEM/IDA; 

SYSTEM/IDA =1566 BOJ. PP=i., MP=it TIME = 09:^*5:10.6 
% SYSTEM/IDA =1566 -- Welcome to SYSTEM/IDA ~ 
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Scroll Mode 

The SYSTEM/IDA program enters scroll mode when a SYSTEM/IDA command is given to display 
information that requires more than one display page. In this mode, the OPTION LINESPERSCREEN 
control command is enabled. 

The commands listed in table 2-1 are recognized in the scroll mode. All other commands terminate 
scroll mode. 



Table 2-1. SYSTEM/IDA Scroll Mode Commands 



Command 

+ [< increment >] 
- [ < decrement > ] 

1 

$ 

<line number > 

HELP 



OPTION (O) 



Function 

Move forward (backward) one page or the number 
of lines specified by < increment > (< decrement >). 

Display the first page. 

Display the last page. 

Display the page that begins at <Hne number >. 

Display the current and ending line number 
and the command menu. 

Display the current option settings. 
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CONTROL COMMANDS 

Control commands are used to control the execution of the SYSTEM/IDA program. They may be used 
to select a current version of a current job, current environment, current file, and so forth, as well 
as to provide formatted displays of portions of the dump file and to to terminate execution of either 
a single command or the overall SYSTEM/IDA program. They also provide user assistance by enabling 
the display of a command menu as well as syntaxes of individual commands. 

Table 2-2 is a list of control commands that may be used to select items for display. Following the 
table are the individual control command descriptions. 

Table 2-2. Control Commands for Use in Displaying Items 

Command Item Selected 

GET Dump file 

JOB Job and environment 

ENVIRONMENT Environment of current job 

FILE File of current job 

LAYOUT Procedure frame and variable of current 

environment 

MEMORY Memory address in data for current 

environment 

OPTION Options 
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BYE 

The BYE control command terminates the SYSTEM/IDA program. The dump file is not removed. 
Syntax: 

BYE 
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ENVIRONMENT 

The ENVIRONMENT (E) control command selects a current environment and displays information 
about the environments of the current job. If no parameters eu-e included, the environment dictionary 
for the current job is displayed. 

Syntax: 

ENVIRONMENT — 



< number > 
LAYOUT — 



FILE <title> 



SMACHINE < interpreter name > 



Semantics: 

< number > 

This field is used to select a current environment. 

LAYOUT 

The LAYOUT parameter specifies that the layout table is to be loaded from the codefile named 
in the Run Structure Nucleus (RSN) for the current job, rather than from the dump file. This 
capability is useful when entering the LAYOUT command results in the message: 

** Error: Job < Number >: LAYOUT TABLES NOT PRESENT 

If FILE < title > is included, the layout table is to be loaded from the codefile specified by 
< title > rather than from the dump file. The < title > must be in the form A/B ON C. 

SMACHINE < interpreter name> 

SMACHINE < interpreter name> specifies the first name of the interpreter for the current job. 
It is entered to facilitate analysis of a program that used an interpreter with a non-standard first 
name. 

Examples: 



E 1 

E LAYOUT 
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FILE 

The FILE control command selects a current file and displays information about files associated with 
the current job. If no parameter is included, the first page of the File Information Block (FIB) of the 
current file is displayed. 

Syntax: 



FILE 



SUMMARY - 
< number > ■ 



Semantics: 

SUMMARY or S 

The SUMMARY (or S) parameter causes the file dictionary to be displayed. 

< number > 

This field is used to select a current file and causes the first page of the FIB to be displayed. 

Examples: 

F S 
FILE 2 
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GET 

The GET control command selects a current dump file, selects the first job as the current job, and 
displays some general informeition about the dump file. If a system dump file is selected, the MCP 
(JOB 0) is selected as the current job. If no parameter is included, general information about the cur- 
rently selected dump file is displayed. 

Syntax: 
GET — 



•< title > 



< number > 



Semantics: 

< title > 

This field is used to select a current dump file. The SYSTEM/IDA program determines whether 
it is a system dump file, program dump file, or packaged system dump file, and performs version 
checking. < title > must be in the form A/B ON C. 

< number > 

When this field has a zero value, the SYSTEM/DUMPFILE file is selected as the current dump 
file. When the field has a non-zero value, DUMPFILE/ < number > is selected as the current dump 
file. 

If a prior dump file had been selected, it is closed but not removed. 

Examples: 

G 

GET DUMPFILE/PM ON S 
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HELP 

The HELP control command displays either the menu of commands or the syntax of the specified com- 
mand. 

If the SYSTEM/IDA program is in the scroll mode, the following message is included, where < cur- 
rent > is the number of the current line and <last> is the number of the last line in the scroll buffer. 

YOU ARE SCROLLING AT LINE < current > OF <last> 

If no parameter is included, the menu of commands is displayed, along with the current patch level 
compile date. 

Syntax: 



HELP 



< command > 



Semantics: 

<: command > 

This field may contain any control command, program object command, or system object com- 
mand. 

Examples: 

HELP 

HELP LAYOUT 
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JOB 

The JOB control command selects a current job and a current environment and displays information 
about the job. This command is only available in system dumps. The job may be either the MCP or 
one of the jobs in the mix. 

If no parameter is included, the mix summary is displayed. 

Syntax: 



JOB 



SUMMARY - 
< number > 

+ 



Semantics: 

SUMMARY 

The SUMMARY parameter displays the mix summary. 

< number > 

This field is used to select a current job. The SYSTEM/IDA program selects the active environ- 
ment for that job as the current environment and displays the state of the job. 

When this field has a zero value, the MCP is selected. 

When this field has a non-zero value, a job in the mix is selected. 

+ 

The + parameter is used to select the next job as the current job. If the MCP was the current 
job, the first job in the mix is selected. If a job in the mix was the current job, the next job 
in the mix is selected. 

Examples: 

J 

J 581 
J -I- 
J 
J S 
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LAYOUT - SDL2 Program 

The LAYOUT control command is used to select a current procedure frame, to select a current 
variable, and to display a history of procedure calls and information about the variables and arrays 
accessible to the procedures of the current job. 

The layout tables are a representation of the variable and array declarations. They provide the template 
for the SYSTEM/IDA program to interpret the contents of a dump file. 

This command includes the concept of a current procedure frame and a current variable. A current 
procedure frame is selected by transmitting LAYOUT < number >. A current variable is selected by 
transmitting LAYOUT VAR <name>. If no current variable has been selected, subsequent LAYOUT 
commands analyze all variables in a frame. 

The LAYOUT command does many things, depending on the state of the analysis. These things can 
best be described programmatically: 

1. If the layout tables for the current job are not loaded, load the layout tables. 

2. If a SUMMARY parameter is present, display the layout summary. 

3. If a SUMMARY parameter is not present, consider the following: 

If a < number > field is present, select a current procedure frame. 

If a VAR < variable name> is present, select a current variable. If VAR parameter is present 
without a variable name, clear the current variable. 

If there is a current variable search for the current variable within the current procedure frame, 
display the value. If the ADDRESSES switch is set, the addresses are displayed. 

If the SIMPLETYPES switch option is on, it is temporarily turned off for variable analysis by the 
LAYOUT VAR form of this control command. 

Syntax: 



LAYOUT 



SUMMARY 
< number > 



r 



VAR 



< name > 



< address > 
< range > 



Syntax for < address >: 



< number > 



@ < number > @ 



I ABS ' 
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' < number > ' 



Syntax for < range >: 

( < number > 

Semantics: 

SUMMARY 

The SUMMARY parameter displays a history of procedure calls that shows the flow of control 
from the global procedure to the last procedure called. 

< number > 

This field is used to select a current procedure frame. 

VAR 

This parameter is used to select a current variable and turn on the search mode, or to clear the 
current variable and turn off the search mode. 

< name > 

When this field is present, a current variable (or array) is selected. 

When this field is not present, the current variable is cleared. 

< address > 

When this field is present, the <name> field is used as a template to interpret the contents of 
location < address >. 

The < address > field is a decimal address if it is not bounded by at-sign (@) characters. It is 
a hexadecimal address if it is bounded by at-sign characters. 

The < address > field is relative to the base register of the current job if it is not followed by 
the ABS keyword. It is an absolute address if it is followed by the ABS keyword. 

< range > 

When this field is present, it is used to specify a single array element or a range of array elements 
to be displayed. 

When a single number is included, it specifies the subscript of the array element to be displayed. 

When two numbers are included, they specify the subscripts that bound the range of array 
elements to be displayed. 

Examples: 

L S 

L 6 

L V 

L V CSV 

L V HINTS ABS 

L V TABLE (1 10) 
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LAYOUT - WFL Program 

A subset of the LAYOUT control command is available for Work Flow Language (WFL) program 
analysis. The VAR parameter is not available. 

Syntax: 



LAYOUT 



SUMMARY 
< number > 



Semantics: 

SUMMARY 

The SUMMARY parameter displays a history of procedure calls that shows the flow of control 
from the global procedure to the last procedure called. 

< number > 

This field is used to select a current procedure frame. 
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MEMORY 

The MEMORY control command selects a current memory address, displays an unformatted analysis 
of memory, and displays a formatted analysis of a memory link. 

If no parameter is included, the display shows the contents of memory at the current address. 

Syntax: 



•MEMORY- 



H 
C 
A 
R 
L 



< address > 



Syntax for < address >; 



IZ 



< number > 



< number > @ 



3 



Semantics: 

address 

This field establishes a current address. The address may be specified in decimal or hexadecimal 
notation. Hexadecimal addresses are enclosed in at sign (@) characters. 



H 



R 



+ 



The H keysymbol specifies that memory is to be displayed in hexadecimal representation. 

The C keysymbol specifies that memory is to be displayed in character representation. 

The A keysymbol specifies that all subsequent addresses are absolute. This is the default mode 
for system dump files and invalid for program dump files. 

The R keysymbol specifies that all subsequent addresses are relative to the base register of the cur- 
rent job. This is the default mode for program dump files. 

The L keysymbol displays the system memory link for the current address (system dumps only). 

The + keysymbol increments the current address by either one page or by the number of bits 
specified by the following < address >. 
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The - keysymbol decrements the current address by either one page or by the number of bits 
specified by the following < address > . 

L + 

The L + keysymbols change the current address to the address of the forward memory link and 
display the link. 

L - 

The L - keysymbols change the current address to the address of the backward memory link and 
display the link. 

Examples: 

M C 1400 

M H + 100 

M R 

M C + 

M L @345678@ 
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OPTION 

The OPTION control command allows the entry of options for displaying information. The entry of 
OPTION £ilone displays the current option settings. The options are of two types, switch options and 
value options. See Switch Options and Value Options. 

For further information on options, see Switch Settings, later in this section. 

Syntax: 



OPTION 


1 1 — r ■' 


1 






1 < switch option > ' 

NO 






■V. value upLiuM ^ 


Semantics: 


NO 

Turns off the switch option that follows. 


< switch option 
See Switch 


> 

Of 


)tion 


s. 









< value option > 

See Value Options. 

Switch Options 

All switch options except UPPERCASE and CODECHECK are initially off. 

Syntax: 



ADDRESSES - 
CODECHECK - 
DOUBLESPACE 

LIST 



NEWLINE 



RESTOREBUFFER 
SLIVIPLETYPES — 
UPPERCASE 
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Semantics: 

ADDRESSES 

The ADDRESSES switch option adds the memory addresses of variables to the output of the 

LAYOUT control command. 

CODECHECK 

The CODECHECK switch option enables comparison of code files in the dumpfile with the corre- 
sponding code files on disk by the PM command. 

DOUBLESPACE 

The DOUBLESPACE switch option specifies that subsequent printer output is to be double 

spaced. 

LIST 

The LIST switch option specifies that all succeeding output is to be written to the LINE file in 
addition to the USER file or ODT. 

NEWLINE 

The NEWLINE switch option specifies that the cursor is to be left at the start of the second Ime 
instead of at the HOME position. This capability facilitates repeated + commands when in scroll 
mode. 

RESTOREBUFFER 

The RESTOREBUFFER switch option restores the prior scroll buffer if any. 

SIMPLETYPES 

The SIMPLETYPES (may be abbreviated ST) switch option suppresses analysis of record fields 
and array elements by subsequent LAYOUT commands. 

Note that if the SIMPLETYPES switch option is on, it is temporarily turned off for variable anal- 
ysis by the LAYOUT VAR form of the LAYOUT control command. 

UPPERCASE 

The UPPERCASE switch option specifies that output is to be in uppercase only. 

Value Options 

Each value option has a default value, specified in its description. 

Syntax: 



ARRAYLIMIT 

LINESPERSCREEN 
■ NESTLIMIT 



•NO 



3 



■LINE 



= <number>- 



UT 



<title> 
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Semantics: 

ARRAYLIMIT 

The ARRAYLIMIT value option either interrogates or changes the number of array elements 
analyzed by the LAYOUT command. The default number of array elements analyzed is 64. If 

< number > is not specified, the current value of the option is interrogated and displayed. The 

< number > parameter is used to change the number of array elements analyzed. 

LINESPERSCREEN 

The LINESPERSCREEN value option is valid only in scroll mode. The option either interrogates 
or changes the number of lines per page in scroll mode. The default value of the option is 22. 
If < number > is not specified, then the current value of the option is interrogated and displayed. 
The < number > parameter is used to change the number of Hnes per page. 

NESTLIMIT 

The NESTLIMIT value option controls the format of variables analyzed by the LAYOUT com- 
mand by restricting analysis to a maximum nest level. 

LINE 

The LINE value option either interrogates or changes the title of the LINE file. The default title 
of the LINE file is LINE. If < title > is not specified, the current title of the LINE file is interro- 
gated and displayed. The < title > parameter is used to change the title of the LINE file. The 

< title > must be in the form A/B ON C. A NO entry preceding the LINE option closes the LINE 
file. 
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PM 

Tlie PM control command reads the current dump file and writes the PM file in order to produce 
a packaged dump file. The default name of the PM file is DUMPFILE/PM < nnn > , where <nnn> 
is the next BACKUP file number assigned by the system. 

The default name of the PM file can be overridden by inclusion of a FILE program control instruction 
when the SYSTEM/IDA program is executed. 

A packaged dump file is used when the analysis is not scheduled to be performed immediately or when 
analysis is scheduled to be performed on a different system. 

Syntax: 



PM 



NO CODECHEC 



K 1 



Semantics: 

NO CODECHECK 

The NO CODECHECK keywords eliminate checking for code segment comparison errors between 
the code segments in the dump file and the corresponding code segments on disk. This option 
should not be used for dumps submitted with Field Communication Forms (FCF). 

Examples: 

PM 

PM NO CODECHECK 
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PRINT 

The PRINT control command either writes a formatted analysis of the current dump file or writes the 
output of the specified command to the LINE file. 

Syntax: 

PRINT - 



< command 



3 



Semantics: 



< command > 

This field may contain any command except PRINT. All output associated with the command is 
written to the LINE file. 

Pragmatics: 

When certain commands are included with no parameters, their normal display output is enhanced. 
Those commands and the corresponding enhancements follow. 

Inclusion of the FILE command prints the file dictionary and the FIB for each open file. 

Inclusion of the JOB command prints the job summary and the state of each job in the mix. 

Inclusion of the LAYOUT command prints the layout summary and the contents of each procedure 
frame. 

Inclusion of the MEMORY command prints an unformatted analysis of memory for the current job, 
along with any memory links present. 

Inclusion of the SMACHINE command for SDL2 job prints the SDL2 S-machine summary and the 
output from the CONTROL, DISPLAY, LAYOUT, NAME, PROCEDURE, and VIRTUAL 
parameters. 

Examples: 

P 

P L S 
P DISK 
P JOB 567 
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SMACHINE 

The SMACHINE control command displays SMACHINE information about the current environment 
of the current job. 

For SDL2 environments, if no parameter is included, a SDL2 S-machine summary is displayed giving 
the addresses of the value, evaluation, procedure, and control stacks and of the name and display ar- 
rays, followed by a brief analysis of any virtual memory usage. 

For non-SDL2 environments, no parameters are used. The local data area is analyzed, as it was in 
the past, by the DUMP/ANALYZER program. 

Syntax: 



SMACHtNE 



<id> 



< address > 



DISPLAY BASE < address > 



VIRTUAL 



< address > 



Syntax for <id>; 



CONTROL 

DISPLAY • 

LAYOUT • 
NAME 



PROCEDURE 



Syntax for < address >; 



< number > — 
@ <hex> @ 
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Semantics: 

CONTROL 

The CONTROL parameter displays a formatted analysis of the control stack. The < address > 
field may be used to change the address of the control stack when the starting address has been 
corrupted. 

DISPLAY 

The DISPLAY parameter displays a formatted analysis of the display array. The < address > field 
may be used to change the address of the display array when the starting address has been cor- 
rupted. 

LAYOUT 

The LAYOUT parameter displays a formatted analysis of the data described by the name array 
entries. 

NAME 

The NAME parameter displays a formatted analysis of the name array. The < address > field may 
be used to change the address of the name array when the starting address has been corrupted. 

PROCEDURE 

The PROCEDURE parameter displays a formatted analysis of the procedure stack. The < ad- 
dress > field may be used to change the address of the procedure stack when the starting address 
has been corrupted. 

DISPLAY_BASE < address > 

The DISPLAY_BASE parameter changes the address of the base of the display array to < ad- 
dress >, thus changing the procedure stack base as well. 

VIRTUAL 

The VIRTUAL parameter displays a formatted analysis of virtual memory. 

VIRTUAL < address > 

When the VIRTUAL parameter is followed by an < address > field, a formatted analysis of the 
memory link at < address > is displayed. 

Examples: 

S P 

S VIRTUAL 

S V @A5B6C7@ 
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?BRK 

The ?BRK control command terminates processing of the current command. 
Syntax: 



-7BRK' 



2-24 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

The System/IDA Program 



PROGRAM OBJECT COMMANDS 

Program object commands display data that is available both in program dump files and in system 
dump files. Program object commands that require more than one display page force SYSTEM/IDA 
into scroll mode. All program object commands apply to the current job. 

Syntax: 



DATA 




ESN 



FIB 



FPB ■ 
IPC - 
FPB ■ 
■RSN 



COMMUNICATE 



DICT 



EVENTLIST 
J^NTEGRITY 
OVERLAY- 
TASK 



SPAD 



DATA 

Displays the Data Dictionary, Data Segments, or Interpreter Data for the current environment. Data 
Segments are only available in a program dump. 

ESN 

Displays the Environment Structure Nucleus for the current environment. 

ESN COMMUNICATE 

Displays the Communicate message for the current environment. 
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FIB 

Displays the File Information Block for the current file. The FIB command displays the same informa- 
tion as the FILE < number > control command. 

FIB DICT 

Displays the FIB Dictionary. The FIB DICT command displays the same information as the 
FILE SUMMARY command. 

FPB 

Displays the File Parameter Block for the current file. The FPB command is only available in program 
dump files. 

IPC 

Displays the Inter-Program Communication information for the current job. 

PPB 

Displays the Program Parameter Block. 

RSN 

Displays the Run Structure Nucleus. 

RSN EVENTLIST 

Displays the event list. 

RSN OVERLAY 

Displays the overlay descriptor. 

RSN INTEGRITY 

Displays the results of a RSN integrity check. 

RSN TASK 

Displays the task variable table. 

SPAD 

Displays the Scratchpad for the current environment. 
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SYSTEM OBJECT COMMANDS 

System object commands display data that is available only in system dump files. System object com- 
mands that require more than one display page force SYSTEM/IDA into scroll mode. 

Syntax: 



BNA 



CHANNELS 
CODE 



CHECK • 



■f- CSV 

- DCH 

- DFH 

- DISK 

- DMS 



ERRORTABLE 
HINTS 



COMM 
DCPU • 



INTERPS 
I OAT 



IPC RUL 
LINKS - 



' ALL ' 



MPB 



NAMETABLE 
DDT 



-QUEUE 



-DESCRIPTOR- 



■ PACKS 



-PSR. 



-QUEUES- 



ALL 

074 

Q.UEUE-<id> 

REMOTE 

STATION [ < id > ]- 



STATE 
TAPE- 



TRACE 



1152055 



2-27 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

The System/IDA Program 



BIMA 

Displays the BNA memory area. 
CHANNELS 

Displays the I/O channel tables. 
CODE 

Displays the code dictionary for the current environment. 

CODE CHECK 

Displays the code comparison errors. 

CSV 

Displays the cold start variables. 

DCH 

Displays the active data communication channels and network controller information. 

DFH 

Displays the disk file header dictionary. 

DISK 

Displays the disk descriptor chain and extended result descriptor chain. 

DISK S 

Displays only disk descriptors those not yet completed and those in error. 

DMS 

See DMS Commands. 

ERRORTABLE 

Displays the correctable error table. 

HINTS 

Displays the Hints record. 

HINTS COMM 

Displays the communicate splitter mask for routing program communicate messages to either the 
SMCP or the MMCP. 

HINTS DCPU 

Displays the DCPU information and the lock management data. 

HINTS TT 

Displays the truth table for marking the patch level of the SMCP. 
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INTERPS 

Displays the Interpreter Dictionary. 

lOAT 

Displays the Input-Output Assignment Table (lOAT). 

IPC RUL 

Displays the Inter-Program Communication Run Unit List. 

LINKS 

Displays a general analysis of system memory links, a memory usage summary, and a specific analysis 
only of bad system memory links. 

LINKS ALL 

Displays a general analysis of system memory links and a specific analysis of each system memory 
link. 

MPB 

Displays the MCP Parameter Block. 
NAMETABLE 

Displays the name table for system software names and disk addresses. 

ODT 

Displays the ODT queue starting with the most recent entries. 

ODT QUEUE 

Displays the same information as the ODT command. 

ODT DESCRIPTOR 

Displays the ODT descriptor chain, the ODT buffer, and the ODT/SQUASH globals. 

PACKS 

Displays the disk cartridge/pack information tables. 

PSR 

Displays the Pseudo Reader Information. 

QUEUES 

Displays the queue information global parameters and queue descriptors. 

QUEUES ALL 

Displays all queue descriptors. 
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QUEUES C74 

Displays only COBOL74 datacomm queue descriptors. 

QUEUES QUEUE- < id > 

Displays all queues with the given multifile-id. 

QUEUES REMOTE 

Displays only file queue descriptors. 

QUEUES STATION [LSN] 

Displays station queues. If an LSN is specified, displays that station only. 

STATE 

Displays the processor state including the interrupt queue, the GISMO work area, the master and slave 
processor scratchpad registers and A-stack, and the master and slave processor MMCP data. 

TAPE 

Displays all tape descriptor chains. 

TRACE 

Displays the GISMO trace table. 
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DMS COMMANDS 

DMS alone was the only valid DMS command in the previous release. Now, DMS entered alone returns 
the following message: 

**WARNING** the DMS command is no longer valid. Try DMS HELP 

For the 12.0 release, there are twelve DMS commands, as shown in the syntax diagram and the descrip- 
tions that follow it. 



Syntax 
DMS 



•ALL 



AUDIT 



BUFFER 



CURRENT 



DATABASE 



HELP 
JOB - 



JOB BUFFER 



•JOB CURRENT 



NO BUFFERS 



" TOUCH BITS ON •' 



< area number > < block number> 



< job number> < invoke number> 



' < database name> 



t: 



SELECTONLY 



• < job number> 



n 



SELECTONLY 



n 



< area number> < block number> 



n 



< invoke number > 



JOB STRUCTURE 
STRUCTURE 



< structure number > 



•SELECTONLY 



SUMMARY 



H 



1152055 



2-31 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

The System/IDA Program 



DMS ALL 

For each opened data base, this command displays the DMS globals and the audit FIB as well as the 
two I/O descriptors belonging to the data base. For each opened structure, the following is displayed: 

» The structure record. 

• All the current records. 

• If SWITCH2 is less than 3, all the buffer descriptors. Moreover, if the structure is an index 
(INDEX SEQUENTIAL or INDEX RANDOM), the tail part of each buffer is displayed. 

• If SWITCH2 equals 0, and NO-BUFFERS has not been specified in the DMS command, and 
a print has been requested (PRINT DMS ALL), all the buffers are printed in hexadecimal. 

DMS AUDIT 

The audit command displays the audit FIB and the memory address of the buffers. If disk is the audit 
file medium, the disk file header is also displayed. 

DMS BUFFER 

To use this command, a data base and a structure must first be selected. (See the DMS DATABASE 
and DMS STRUCTURE commands.) 

DMS BUFFER 

Displays, for each buffer belonging to the selected structure, the logical address, the touch bits, 

the user count, and the status flags: media (Bd in memory), to be written, control point, and 

I/O error. Figure 2-1 is an example of the display. 

DMS BUFFER "TOUCH BITS ON" 

Displays all buffers with touch bits not equal to zero. 

DMS BUFFER <area number > < block number > 

Displays the front part of the buffer (Buffer descriptor) and the address of the buffer itself. If 

the structure is an index, the tail part of the buffer (Buffer end descriptor) is also displayed. 

To see the contents of the buffer, enter the MEMORY control command. (See MEMORY, in this 
section.) 

DMS CURRENT 

To use this command, a data base and a structure must first be selected. (See the DMS DATABASE 
and DMS STRUCTURE commands.) 

DMS CURRENT 

Displays each current with its job number, invoke number, and locks. Record number is relevant 
for lists and datasets only. Entry number is relevant for lists and indexes only. Figure 2-2 is an 
example of the display. 

DMS CURRENT <job number > < invoke number > 
Displays the entire current. 
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DMS DATABASE 

Displays each data base with a list of the jobs using it. For each job listed, the full name (pack id, 
mfid, fid) and the job number are displayed. Figure 2-3 is an example of the DMS DATABASE dis- 
play. 

DMS DATABASE < database name> 

Displays a single data base and provides additional information about it. The pack name is not 
needed because DMS prohibits two data bases with the same name, even if they are on different 
packs. If the data base name contains odd characters, for example: 2MWDB, the data base name 
must be enclosed in quotes. 

The named data base is selected as context for subsequent commands, and the DMS globals record 
is displayed. 

DMS DATABASE < database name> SELECTONLY 

Allows the selection of a data base without the DMS globals record. The following is displayed: 
DATABASE < database name> SELECTED 
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to be written control point " 
media ! ! I/O error " 


"<--aclclr~> 
"area block 


touch 111! " 
bits user V V V V " 


"123 123'*5 
"012 0123^ 
"001 00123 


@11@ 16 Y N Y N " 
@01@ 01 N N N N 
@00@ 03 Y Y Y Y 



Figure 2-1. Example of DMS BUFFER Display 



restart lock 

record lock_ ! 

user lock ~I ! 

"! ! ! 

V V V 

< user current ><"-working current > 

< address — >points at< — address >points at 

job invoke area blk rec entry area bik rec entry 



123't (>'* 
4321 63 



101 
001 



3^5 - 
001 010 



256 



nothing 001 
current 101 



001 - 
3^5 123 



123 



next 
prior 

user lock 



Y N Y 
N Y N 

I ! 



Figure 2-2. Example of DMS CURRENT Display 



***** Data base <database name> ***** 



<-- 



user count 

update user count 

updated 

programs ok 

recovery In process 

reorganization running 

globals lock 

audit lock 

transaction lock 

recovery in process 

reorganization in process 

■job name > job nbr 



a/b/c 
d/e/f 



123't 
4321 



5 

3 

YES 

YES 

NO 

NO 

NO 

YES 

YES 

NO 

NO 



Figure 2-3. Example of DMS DATABASE Display 
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DMS HELP 

This command is context sensitive; that is, its output depends on preceding commands. Syntax as well 
as instructions are provided. 

DMS JOB 

To use this command, a data base must first be selected. (See the DMS DATABASE command.) 

DMS JOB 

Displays the names and numbers of the jobs using the selected data base. For each job, the full 
name (pack id, mfid, fid), number, actual environment, job status, and relevant flags are dis- 
played. Figure 2-4 is a sample display. If the job is rolled out, the flags are not displayed; instead, 
the message "Job Rolled Out" is displayed. 

DMS JOB <job number > 

Displays the DMS interface area of the specified job. 

DMS JOB <job number > SELECTONLY 

Selects the specified job, without displaying the interface, and responds with 

JOB <job number > SELECTED 

DMS JOB BUFFER 

To use this command, a data base, a job, and a job structure must first be selected. (See the DMS 
DATABASE, DMS JOB, and DMS JOB STRUCTURE commands.) The command is similar to DMS 
BUFFER but operates in a different context. 

DMS JOB BUFFER 

Displays all the buffers belonging to the currents for the selected job and job structure. For each 
buffer, the logical address, the touch bits, the user count, the flags, and the entry number are 
displayed. For indexes, only the entry number is relevant; for lists, both record number and entry 
number are relevant. 

DMS JOB BUFFER <area number > < block number > 
Displays the contents of the buffer specified. 

DMS JOB CURRENT 

To use this command, a data base, a job, and a job structure must first be selected. (See the DMS 
DATABASE, DMS JOB, and DMS STRUCTURE commands.) This command is similar to the DMS 
CURRENT command but operates in a different context. 

DMS JOB CURRENT 

Displays all the currents and, for each current, the invoke number, the logical address (consisting 
of the area number, block number, and record number), the entry number, and the locks. 

DMS JOB CURRENT < invoke number > 
Displays the entire current. 
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DMS JOB STRUCTURE 

To use this command, a data base and a job must first be selected. (See the DMS DATABASE and 
DMS JOB commands.) The DMS JOB STRUCTURE and DMS STRUCTURE commands are similar 
but work in different contexts. 

DMS JOB STRUCTURE 

Displays all the structures that are in use by the job specified. For each structure, the structure 
number, user count, update user count, structure type, parent structures, object structures, and 
some locks are displayed. 

DMS JOB STRUCTURE < structure number > 

Causes the specified structure to be selected as context for subsequent commands and displays the 
structure record, file record, and disk file header. 

DMS JOB STRUCTURE < structure number > SELECTONLY 

If the user wants to select a structure and does not want any more information, the reply is: 

STRUCTURE < structure number > SELECTED 
DMS STRUCTURE 

To use this command, a data base must first be selected. (See the DMS DATABASE command.) 

DMS STRUCTURE 

Displays all opened structures, giving the structure number, user count, update user count, struc- 
ture type, parent structure number, object structure number, and some locks. Figure 2-5 is an ex- 
ample of the display. 

DMS STRUCTURE < structure number > 

Displays the structure record, the file record, and the disk file header. The structure is selected 
as the context for subsequent commands. 

DMS STRUCTURE < structure number > SELECTONLY 
Selects a structure and gives the following response: 

STRUCTURE < structure number > SELECTED 
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1 


nbr 


fatal error 
















' 


in transaction 












"! 
V 




' 


1 am aborting 










V 




1 


aborted 








"! 
1 

! 
1 
V 




1 
1 
1 

1 

' name 


backing out 
updating 
opened update 

env < — status > 


~! 
V 


! 
V 


"! 

! 
I 
V 


V 


' a/b/c 
' d/e/f 
' g/h/i 


1234 
4321 
0123 


usr waiting DS/DP 
dms executing 
mcp executing 


Y 
Y 
Y 


N 
Y 
N 


N 
Y 
Y 


N 
Y 
N 


N 
Y 
Y 


N 
Y 
N 


N ' 

Y 

Y ' 



ROLLED OUT 



Figure 2-4. Example of DMS JOB Display 



: structure > < — users — > < locks > 

type nbr object parent all upd memory buffer cur_link currents 



MSS 4 

RSDDS 7 

EDS 1 

IDXSEQ 6 



1023 
1021 

1019 
1017 



1022 
1020 
1018 
1016 



10 


11 
3 



3 



11 

1 



Y 
Y 
N 
N 



Y 
Y 
N 
Y 



N 
Y 
N 
N 



N 
Y(EX) 
Y 12 
Y(02) 



Y (EX) means exclusive lock. 

Y (xx) means non-exclusive lock with xx users. 



Figure 2-5. Example of DMS STRUCTURE Display 
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DMS SUMMARY 

This command produces a display that provides an overview of what was going on when the dump 
was taken. The display includes the summary information for data bases, structures, and currents. 

lEach data base name is displayed. For each, the user count and other summary information is in- 
cluded, along with the locks (global, audit, and transaction). 

IFor each data base name, all the structures in memory are shown. For each structure, the locks (buffer 
lock, current lock, current link lock), the type, user count, update user count, object structure, parent 
structure, and the currents are shown. 

For each current, the job number, the invoke number, the logical address, and the user lock are shown. 

Figure 2-6 is an example of the display. 



***** Data base <clatabase name> ***** 



user count 

update user count 

updated 

programs ok 

recovery in process 

reorganization running 

globals lock 

audit lock 

transaction lock 



5 

3 

YES 

YES 

NO 

NO 

NO 

YES 

YES 



** Structure <structure number> ** 
type* INDX RANDOM user cnt«»12 update user count=10 
buffer lock"Y current lock"Y(EX) current link lock"Y 
object structure ■ 7 parent structure ■ - 
* Currents * 

restart lock 

record lock_ I 

user lock "1 ! 

~! ! ! 

V V V 

< user current ><- — working current > 

< address — >points at< — address >points at 

job invoke area blk rec entry area blk rec entry 



123^ 64 
4321 63 



101 
001 



345 - 
001 010 



256 



nothing 001 
current 101 



001 - 
345 123 



123 



next 
prior 



Y N Y 
N Y N 



ilS 



means non-exclusive lock with xx users. 



Figure 2-6. Example of DMS SUMMARY Display 
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SWITCH SETTINGS 

Following are the SYSTEM/IDA program switch settings. In all cases, zero is the default setting. 



Switch 




Settings 



5 
6 

7 
8 



- Analyze only the first 64 elements of each array. 

1 ■ Analyze all elements of each array. 
2-15 «= Do not analyze arrays. 



"Allow comparison of resident code, 
microcode segments to their copies 
1-15 = Suppress code segment comparison. 



interpreter, and 
on di sk. 





1 
2-15 


1-15 


1-15 





1- 


15 




1 






1- 


•15 




1 

2 





only. 



t-15 



Display DMS and ISAM buffers. 

Suppress DMS and ISAM buffer data 

Suppress DMS and ISAM buffer descriptors and data. 

Suppress printing of certain (already analyzed) memory 

areas during the hexadecimal dump. 

F>rint all areas of memory during the hexadecimal dump. 

Flemain in loop until exit conditions are satisfied. 
Decrement SW k and exit loop unconditionally. The 
semantics of this switch are functionally the same 
as those of the corresponding switch in the 
MCP I I /ANALYZER program. 

Analyze all ODT queue entries. 

Analyze only the last 25 percent of the ODT queue. 

Print available memory areas during hexadecimal dump. 
Suppress printing of available memory areas. 

Reserved for future use. 

If incorrect MCP level, abort analysis. 
Attempt analysis regardless of MCP level. 

Default option UPPERCASE » ON. 

Default options UPPERCASE and DOUBLESPACE - OFF 

Default options UPPERCASE and DOUBLESPACE - ON 

Default option DOUBLESPACE - ON 

Same as setting 1 . 
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EXCEPTION CONDITIONS 

The SYSTEM/IDA program informs the user upon the detection of corruption in the dump file. The 
user may then decide how much analysis is worthwhile. 

When an exception situation is encountered, a message describing the problem is displayed, followed 
by a menu of possible user responses, and a request for input. 

FILE NAMES 

Table 2-3 shows the internal and external file names of the files associated with the SYSTEM/IDA 
program and their functions. 



Table 2-3. SYSTEM/IDA File Information 



Internal 


External 


File Name 


File Name 


LINE 


LINE 


USER 


USER 


DUMPFILE 


SYSIEM/DUMPFILE 


DISK 


IDA/DISK 


PM 


DUMPFILE/PM < nnn > 



CEFILE 
CDFILE 
TEXTFILE 
LINKFILE 



CEFILE 
CDFILE 
IDA/TEXTFILE 
LINKFILE 



Function 

The printer output file. 

The user's remote file. 

The current dumpfile. 

A temporary work file. 

The packaged dump file written 

by the PM control command, where 

<nnn> is the next BACKUP file 

number assigned by the system. 

File equation to tape is 

allowed. 

A temporary work file. 

A temporary work file. 

A temporary work file for scrolling. 

A temporary work file. 
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SECTION 3 
OPEF^ATIIMG SYSTEM COMPONENTS 



The Burroughs B 1000 operating system is a modular supervisory program that takes charge of fre- 
quently used functions and thus simplifies and expedites the preparation and running of programs and 
the overall operation of the system. 

The operating system consists of the following three separate components. 

Component Abbreviation 

Master Control Program II SMCP 

MCPII/MICRO-MCP MMCP 

GISM03 (or GISM02) GISMO 

These three components perform the following functions: 

• Scheduling, initiating, executing, monitoring, and terminating programs as requested by users. 

• Providing a symboHc means of communicating with the system while shielding users from the 
details of the hardware. 

• Identifying, managing, and retaining memory and disk areas for maintenance of programs and 
files. 

• Managing the system resources for optimum utilization by many concurrent operations. 

The B 1000 operating system components are programs written in the System Development Language 
(SDL2) and the Micro Implementation Language (MIL). 

SDL2 is a high level language used for writing B 1000 system software. SDL2 program instructions 
are performed by the SDL2 interpreter, as opposed to being executed directly on the B 1000 computer 
system hardware. An example of a SDL2 program is the MCPII program, the portion of the operating 
system written in SDL2. 

MIL is the Micro Implementation Language on the B 1000. MIL is a machine level language used for 
writing B 1000 system microcode. MIL programs execute directly on the B 1000 computer system hard- 
ware. An example of a MIL program is the MCPII/MICRO-MCP program, the portion of the operat- 
ing system written in MIL. Other examples of MIL programs are the SDL2 interpreter and GISMO. 

The operating system components are described in the following paragraphs. 
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GISMO (GISM03 AND GISM02) 

Gismo is a MIL program, executed directly, which contains procedures for the following operating sys- 
tem functions: 

• Processor scheduling. 

• Physical input and output operations. 

• System interrupt handling. 

• Memory allocation under prioritized memory management. 

• Communicate message routing. 

• Complex wait (COBOL68, COBOL74, SDL2 WAIT) statement. 

• System performance monitoring. 

• Tracing. 

In a dual processor system, Gismo can execute on either processor. A system of memory locks and 
conventions allows shared access to memory structures. 

MMCP (MCPII/MICRO-MCP AND MICRO-MCP/DEBUG) 

The MMCP is a MIL program, executed directly, which contains procedures for processing the fol- 
lowing communicate messages: 

• Logical input and output operations (record blocking and unblocking). 

• COBOL74 interprogram communication. 

The MMCP is also called when a reader/sorter operation completes. 

In a dual processor system, the MMCP can execute on either processor. A system of memory locks 
and conventions allows shared access to memory structures. 

SMCP (MCPII) 

The SMCP is an SDL2 code file, interpreted by the SDL2 interpreter, which contains code for all oper- 
ating system functions except those listed for the MMCP and GISMO. 

The SMCP can only execute on the master processor. 
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SECTION 4 
PROBLEM ANALYSIS OVERVIEW 



The purpose of a system memory dump operation is to find the fundamental cause of a system prob- 
lem. For example a symptom such as a system halt with the L-register = @0DO055@ has, as its imme- 
diate cause an attempt to read or write outside the bounds of memory. Further investigation is needed 
to determine the underlying (fundamental) cause. Further investigation includes a request for a system 
memory dump and the analysis of the resulting system memory dump file. This may (but does not 
always) reveal the fundamental cause. 

When a B 1000 system is not performing any work, the first step is to determine whether it is hung 
or halted. If the system is hung, the next step is to determine what is required to halt it. 

The following paragraphs provide an overview of the steps required to analyze a malfunctioning sys- 
tem. 

IMMEDIATE CAUSE OF A PROBLEM 

The immediate cause of each software controlled system halt is listed in the system halt table contained 
in section 8 of the B 1000 Systems System Software Operation Guide, Volume I. The hardware L-regis- 
ter provides the primary halt definition. For many halts, the T, X, and Y registers contain additional 
information which assists in locating the fundamental cause of the problem. 

The immediate cause of a system hang can be determined by following the instructions that are pres- 
ented next. 

FUNDAMENTAL CAUSE OF SYSTEM HANG 

When a system hangs, the fundamental cause may be determined by going through a sequence that 
takes advantage of what the system does or does not do in response to specific inputs: 

1. System responds to ODT. 

2. System responds to INTERRUPT. 

3. System responds to HALT. 

4. System responds to HALT/CLEAR. 

In the paragraphs that follow, this sequence is described in the order in which the steps should be tak- 
en. 
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System Responds to ODT 

GISMO runs the SMCP, the network controller when using a datacomm ODT, and the SYSTEM/ODT 
program, but no other work is being performed. A probable cause of the problem is that a high- 
priority job with no input or output operations is taking all the processor time. When such a job wants 
the processor, it takes precedence over all jobs of lower priority. 

iSystem performance monitoring or the MX ALL system command followed by repeated 
<mix number > TI system commands can be used to determine which job has control of the processor. 
Adjusting the priorities of the jobs in the mix may cause other work to resume. If this does not identify 
the cause, interrupt the system, take a clear/start system memory dump, and locate the job whose 
QUEUE_ID is NOT_QUEUED. 

System Responds to Interrupt 

The system does not respond to ODT input. 

One possible cause is that the SMCP program is busy and cannot accept requests to perform any other 
iservices. A job, including the SYSTEM/ODT program, that needs service from the SMCP program 

will wait in the SMCP communicate queue (S__COMM Q) until the SMCP can respond. As time goes 

by, more and more jobs cease performing work while they wait for the SMCP. 

Another possible cause is that the priority of either the SYSTEM/ODT program or the network con- 
troller program when using a datacomm ODT has been set lower than some job with no input or out- 
put operations and the latter is taking all the processor time. For this reason SYSTEM/ODT and the 
network controller should be at the highest priority in the mix. Other programs, such as SMCS and 
SYSTEM/MONITOR, can share that priority. 

Another possible cause is that the SYSTEM/ODT program is hung. If SMCS and RD are running, 
it may be possible to use commands from a remote ODT via SMCS and RD to determine the problem. 
Zip input goes directly to the MCP and can bypass an ill SYSTEM/ODT. 

To determine the cause of the problem, interrupt the system and perform a clear/start system memory 
dump. Execute the SYSTEM/IDA program, get the SYSTEM/DUMPFILE file, and verify that the 
SMCP QUEUE__ID is NOT_QUEUED. Then enter the SYSTEM/IDA command LAYOUT SUM- 
MARY to see the history of SMCP procedure calls. 

System Responds to HALT 

The system does not respond to ODT input or to activation of the console INTERRUPT push button. 

One of the interpreters listed in the interpreter dictionary had control of the processor, was stuck in 
a loop, and could not get out to test for any interrupt. A possible cause is a malfunction in the I/O 
.subsystem. It may be sending service requests at a rate that does not give GISMO time to exit the 
module that handles service requests to test for other interrupts. 

To determine the cause of the problem, halt the system, record the registers specified in the Fault Do- 
cket, and perform a clear/start system memory dump operation. The value in the A register is the ad- 
dress of the next microinstruction to be executed. That value, together with the information in the in- 
terpreter dictionary, determines which program segment listed in the dictionary had control of the pro- 
cessor. The STATE A @hhhhhh@ system object command, using the interpreter dictionary, will de- 
code the A register. The values in the other registers provide useful information for determining what 
caused the program segment to loop. 

^^2 
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If the value in the A-register indicates that GISMO had control of the system, look through the I/O 
descriptor chains in the SYSTEM/IDA listing to determine which descriptors had been initiated. When 
there is a system hang with GISMO in control of the system, the memory dump often fails to show 
the cause of the problem. If the I/O subsystem is suspect, the next step in trying to isolate the cause 
is to run a GISMO trace of all I/O channel activity. 

System Responds to HALT and CLEAR 

When HALT and CLEAR must be activated simultaneously to halt the processor, a processor malfunc- 
tion has occurred, and a Burroughs Field Engineer must be notified. A system memory dump is unnec- 
essary. Perform a clear/start operation, and try to resume processing. 

FUNDAMENTAL CAUSE OF SYSTEM HALT 

If the halt occurred in GISMO, the MMCP, or the SDL2 interpreter, the L-register contains a value 
listed in section 8 of the B 1000 Systems System Software Operation Guide, Volume 1. That value, 
together with any additional information specified as being included in the T, X, and Y-registers, estab- 
lishes starting points for analyzing the system memory dump. For example, when the L-register indi- 
cates a GISMO halt associated with an I/O problem, the starting points are (1) the appropriate I/O 
descriptor chain, (2) the most recent procedure in the SMCP layout summary, (3) the communicate 
message of the program performing the I/O operation, and (4) the FIB for the file being referenced. 

An L = @0D0055@ (D-55) system halt occurs when GISMO discovers an attempt to read out of the 
bounds of addressable memory. This event usually is not detected until some time after it occurs. At 
the time of the halt, if the Y-register contains zero, the error occurred in GISMO. If it contains a 
value other than zero, the X-register contains the contents of the limit register of the program that 
was running when the error occurred. 

WHEN IS ADDITIONAL INFORMATION NEEDED? 

A system memory dump does not always show the fundamental cause of a problem. Examples of such 
cases include problems resulting from to the corruption of a disk address and system hangs for which 
the memory dump fails to show a cause. 

Problems associated with invalid disk addresses are usually caused by an address that became invalid 
long before its reference caused the immediate problem. Frequent execution of the SYSTEM/PANDA 
program may help isolate the time frame within which the corruption occurred. Printouts of formatted 
analyses of the SYSTEM/LOG and the SYSTEM/ELOG may show a pertinent activity sequence and 
any I/O errors that occurred during that time. 

Locating the cause of a system hang frequently is not possible without a GISMO trace. If an I/O chan- 
nel is suspected of requesting the undivided attention of GISMO, a GISMO trace of that channel will 
show it. If there is no specific suspect, a GISMO trace with all trace flags set is the first step in trying 
to locate the cause of the problem. 

WHAT TO DO WHEN THE PROBLEM IS LOCATED 

If hardware is the fundamental cause of a problem, then a Burroughs Field Engineer should be called. 
If the problem is software, the B 1000 Product Support Information Manual (PSIM) may contain a 
corrective measure. 

On the first occurrence of a problem, write a description on a Field Communication Form (FCF) and 
send it, with appropriate supporting documentation, to a Burroughs Software Support representative. 
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The state of the software at the time a system memory dump is taken provides information on the 
job and the operating system component under which it was running. All software-controlled halts oc- 
cur when an operating system component detects invalid data in memory or in a register. The pertinent 
operating system components are GISMO, the MMCP, the SMCP, and the components that are active 
during a clear/start operation (CLEAR/START and SYSTEM/INIT). Knowing which version of an 
operating system component was in use is a key for determining whether the problem has been cor- 
rected with a later release of the system software. 

When the SDL2 interpreter halts the system on behalf of the SMCP, the first two digits of the L- 
register are 00. If the SMCP was performing a service for one of the jobs in the mix, the Job queue 
for the job will be NOT_QUEUED. The SYSTEM/IDA program object command 
ESN COMMUNICATE applies to the current job and displays the communicate message sent to the 
SMCP. The control command LAYOUT displays the procedure call history and the contents of the 
SMCP name stack. 

When the MMCP halts the system, the first two digits of the L register are 02. The MMCP firmware 
performs services for a job that sends a communicate message. The job queue for the job is 
NOT QUEUED, and the communicate message is displayed when ESN COMMUNICATE is entered. 

When GISMO halts the system, the first two digits of the L register are OD. For many of the GISMO 
halts, GISMO has been doing some service for the SMCP or the MMCP, and the X register contains 
the contents of the Limit register of the applicable component. The cause of the problem can be traced 
from GISMO back to component and, if necessary, back to the job that sent the communicate mes- 
sage. 

VERSION AND STATE OF THE SMCP 

The SMCP version number and compilation date are displayed in the outputs of the SYSTEM/IDA 
control commands GET SYSTEM/DUMPFILE and JOB 0, as shown in the following example: 

MCP VERSION = MARK 12.0.00 (10/26/84) 

The SMCP state is found in the same display in the field labeled Job queue, which may have any 
of the following values: 

NOT_QUEUED 

The SMCP is running, or GISMO is running on the master processor. 

READY_Q 

The SMCP is ready to resume execution. 

WAIT_Q 

The SMCP is waiting for one or more events in the event list. When the event is TRUE, the SMCP 
is moved to the queue specified by the Next queue field. 
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SMCP EVENT LIST 

The SMCP event list is displayed in the output of the SYSTEM/IDA program object command 
RSN EVENTLIST. The event list is a list containing, typically, two or five entries. 

When the SMCP QUEUE ID is WAIT_Q, and the event list contains five entries, the list shown next 
appears in the SYSTEM/IDA display. 



**A EVENT LIST *** 

EVENT ADDRESS 

(gyDSceSO FALSE 

1 OOOOSSif® FALSE 

2 @7C379B@ FALSE 

3 ©000552® FALSE 
it ©00031 F® FALSE 



(RS TIME EVENT) 

(S H QEV) 

(0(Jt_empty, to THE_MCP) 

(S C Q EV) 
(CHARcr BIT) 



The meanings of the entries in a five-entry event list are as follows: 

RS_T1ME_EVENT 

The SMCP requested GISMO to wake it up after a 5-second to 60-second time interval. The time 
interval is proportional to the number of jobs in the mix. 

The following fields in HINTS and the SMCP run structure nucleus are used. 



HINTS.SYCOUNTER 
HINTS . SY_CNTR__MSK 
HINTS. SY_PRIOR_TIME 
RS_PAUSE 
RS_TIME_EVENT 



current time 

time at which wait time expires 

last time at which wait time expired 

unexpired wait time 

caused when time to wake up the job 



When the time interval has elapsed, RS_PAUSE goes to zero, RS_TIME_EVENT goes TRUE, and 
the SMCP performs some housekeeping functions, including the following. 

** Handle exterminations 

** Perform CHECK_CHANGE_BIT procedure (explained below) 

** Perform N SECOND procedure as follows: 

** Roll out jobs 

Update date and time 
** Initiate any delayed random I/O operations 
** Load pseudo readers 
** Transfer ELOG 
** Garbage collect queues 
** Fire up SYSTEM/ODT 
** Fire up SYSTEM/BACKUP for autoprint 

If no remote files open for the third time, QC 

the network controller 

DS any job that has exceeded its maximum time 
** Update LOG mix information on the system disk 

** = conditional 
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Q__NOT__EMPTY, ODT__QUEUE__FILE 

An input message was transmitted from the ODT, and the SYSTEM/ODT program put the mes- 
sage in the ODT queue. The SMCP deciphers the message and takes the appropriate action. 

S_M_Q_EV (SMCP interrupt Message Queue Event) 

GISMO has placed one or more of the following possible entries into the Interrupt queue: 

An I/O operation completed, and the SMCP had requested notification by setting the 

RESULT_STATUS INT_REQ bit in the I/O descriptor, and M_EVENTS INT__M__OR S 

bit was FALSE. 

An I/O operation completed, and the SMCP had requested notification by setting the 
M__EVENTS S_INT_REQ bit in the I/O descriptor, and M_EVENTS INT_M_OR_S bit 
was FALSE. 

An I/O operation completed, and the SMCP had requested notification by setting the 
M_E VENTS INT_.S bit in the I/O descriptor. 

An I/O operation had completed with any exception except datacomm I/O and tape streamer 
tape mark only. All other tape streamer exceptions are routed to the SMCP. 

An S-memory parity error occurred. 

The system is thrashing. 

The SMCP deciphers the interrupt, takes the appropriate action, and then conditionally performs the 
CHECK_CHANGE_BIT procedure. 

Q_NOT_EMPTY, TO_THE_MCP 

An input message was transmitted from the ODT, and the SYSTEM/ODT program put the mes- 
sage in the ODT queue. 

S_C_Q__EV (SMCP Communicate Queue Event) 

A communicate message has been routed to the SMCP program. 

Either GISMO routed a communicate message from a program to the SMCP, or the MMCP needs 
help from the SMCP because of a problem described in the RS_M_PROBLEM_TYPE field. 

The SMCP performs a Q OUT TOP operation on the S-communicate queue to cause GISMO 

to locate the job that did the communicate. 

The SMCP performs the operation indicated by the communicate message. 
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CHANGE_BIT 

A job has either entered the schedule, gone to BO J, or gone to EOJ. 

The SMCP performs the CHECK_CHANGE_3IT procedure, which was also referenced above 
with RS_TIME_EVENT and S_M_Q_EV bits fields, as follows. 

If there is a disk squash (SQ system command) operation to be done and no jobs are running, 
execute the SYSTEM/SQUASH program. 

If an OPEN operation has been performed on a remote file and the network controller is not 
running, execute the network controller program. 

If there are jobs in the schedule, and if any jobs in the mix are waiting because of no memory, 
reinstate the jobs; otherwise, execute a job in the schedule. 

When the SMCP Job queue is WAIT_Q, and the event list contains two index-address pairs, the 
RS_TIME_EVENT field is in the event list as described above, and the M__EVENTS.IOC field is 
in the disk descriptor chain as described below. 

The event list could have the following appearance in the SYSTEM/IDA display: 

*** EVENT LIST *** 
EVENT ADDRESS 

(a7ED7l8@ FALSE {RS TIME EVENT) 

1 @7DACitF@ FALSE {M_rVENTr. I OC) 

The SMCP dispatched a disk I/O operation to GISMO , and then performed a GISMO communicate 
specifying that the SMCP was to be put into the Wait queue until either 30 seconds elapsed or the 
physical disk I/O operation completed. When the event list contains two entries, the entries have the 
following meanings. 

RS_TIME__EVENT 

This event becomes TRUE when 30 seconds have elapsed (RS_PAUSE field goes to zero) and 
the operation has not completed. 

M__E VENTS. IOC 

This event becomes TRUE when the disk I/O is physically complete. 
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VERSION AND STATE OF THE MMCP 

The MMCP version number is found by entering the SYSTEM/IDA command INTERPS. In the fol- 
lowing example, the version number is @ 12000101®. 

> INTERPRETER 

NAME = MCPI l/MICRO-MCP 
VERSION - §12000101® 

Also included here are various local parameters to certain MMCP segments. 

For a system halt, if the MMCP was running, the first two digits in the L register are 02, and the 
next four digits specify what the MMCP was doing when it discovered the bad value and halted. 

For an interruptible system hang, if the interrupt button halted the processor, the MMCP did not have 
control. The MMCP responds to service request and timer interrupts only. 

For a non-interruptible system hang, the MMCP had control of the processor if the LR value written 
in the Fault Docket matches the M MCP LR field in HINTS. 

SYSTEM/IDA STATE Command 

Further information about the state of MMCP, specifically, the contents of the Interrupt queue and 
the MMCP work area, is displayed by the SYSTEM/IDA command STATE. 

VERSION AND STATE OF GISMO 

The GISMO version number is found by entering the SYSTEM/IDA command INTERPS and locating 
interpreter 1. In the following example, the version number is @ 12000101®. 

> INTERPRETER 1 

NAME = GISM03/DEBUG 
VERSION "= §12000101® 

The GISMO state is displayed in the L-register. If the first two digits in the L register are @0D®, 
the next four digits specify what GISMO was doing when it discovered the bad value and halted. Fre- 
quently, the other registers provide additional information. 

GISMO State Flags 

Upon entry to GISMO, the contents of PERM register bits 1 and 3 are tested. Upon leaving GISMO, 
the bits are tested again. PERM(l) indicates a read or write outside the bounds of memory (D-55 halt). 
PERM(3) indicates an uncorrectable CPU access error to S-Memory (D-54 halt). 

If the STATE. FLAGS field in the Y-register contains a non-zero value, the error was detected upon 
entry to GISMO, indicating the error occurred in the program that just called GISMO. The X-register 
contains the limit register of that program. 

If the STATE.FLAGS field contains zero, the error was detected upon leaving GISMO, indicating the 
error occurred while GISMO had control of the processor. 
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SYSTEM/IDA STATE Command 

Further information about the state of GISMO, specifically, the contents of the Interrupt queue and 
the GISMO work area, is displayed by the SYSTEM/IDA command STATE. 

STATE OF EACH JOB IN THE MIX 

The state of each job in the mix is found by entering the SYSTEM/IDA command JOB SUMMARY 
to obtain a job summary display. 

To find the value of a next instruction pointer of the job, enter: 

JOB < number > 

ESN 

and read the value in the NIP field. 

To find the contents of a communicate message field of the job, enter: 

JOB < number > 

ESN COMMUNICATE or ESN C 

To find more information about a job that is waiting for one or more events to become TRUE, enter 
the following: 

JOB < number > or J < number > 

and read the values for Next queue and Job status. 

To find the addresses and values of the events for which a job is waiting, enter the following: 

JOB < number > 

RSN EVENTLIST or RSN E 

The kinds of events upon which jobs in the mix typically wait include an interval of time and other 
conditions specified in a WAIT statement. 
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JOB QUEUE IDENTIFIERS 

Following are interpretations of the various Job queue identifiers: 

NOT QUEUED 

The job is running on either the master or slave processor, or its communicate message is being 
processed, or GISMO is running. On a dual processor system, if the RSN address of the job 
matches HINTS.DCPU_SLAVE_LAST_REIN, then the job is running on the slave processor, 
or its communicate message is being processed, or the slave GISMO is running. 

READY_Q 

The job is ready to resume execution on either the master or slave processor. 

EXTERMINATE_Q 

The job is ready for the SMCP program to discontinue the job on the master processor. 

S_COMM_Q 

The job is ready for the SMCP to begin or resume processing a communicate message on the mas- 
ter processor. 

M_COMM_Q 

The job is ready for the MMCP to resume processing a communicate message on the master pro- 
cessor. Processing could have been interrupted if a MMCP code segment was not present, or if 
a new disk area was needed for a read or write operation. 

IOC_Q 

The job is ready for the MMCP to resume processing a communicate message on either the master 
or slave processor. Processing was interrupted to wait for the completion of some event, such as 
an I/O operation. 

WAIT_Q 

The job is waiting for one or more events in its event list. For better resolution on what the job 
is waiting for, see the Next queue, job status, and event list. When the event becomes TRUE, 
the job is moved to the queue specified by the Next queue field. 

The Next queue, job status, and event list are in a defined state only when the Job queue contains 

WAIT Q. When the Job queue has any other value, these fields exist but are in an undefined state, 

and only the value in the Job queue defines the state of the job. 
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SECTION 6 
STATE OF THE INPUT/OUTPUT OPERATIONS 

The state of the input/output operations at the time a system memory dump is taken provides addition- 
al information about the state of the system. For every input/output operation there is an associated 
result descriptor (I/O descriptor) defining the status of the operation. Since GISMO handles all physical 
soft input and output on the master processor, analysis of the I/O descriptors will provide information 
about the state of the GISMO on the master processor. Hard input and output for MLCs can be initi- 
ated by either processor. Dual processor systems also use port to port communications to send messages 
to each other. This information is useful in analyzing system hangs or halts. 

The I/O descriptors may be divided into two groups: those that are associated with devices on multiple 
unit channels, such as disk and tape, and those that are associated with devices on single unit channels, 
such as card reader and printer. 

The I/O descriptors for devices on multiple unit channels are found by entering a DISK command to 
display the disk descriptor chain and by entering a TAPE command to display the tape descriptor 
chain. 

The I/O descriptors for devices on single unit channels are found as follows: 

1. Enter an lOAT command to display the Input-Output Assignment Table. This table contains 
an entry for every device physically connected to the processor through the I/O subsystem. 

2. Locate the entry for the device of interest. 

3. If a file has been opened on the unit assigned to that device, the unit is connected to a job 
in the mix. 

1) Locate the JOB NUMBER, and note the corresponding FIB ADDRESS. 

2) Enter a JOB < number > command followed by a FILE SUMMARY command. 

3) Locate the file number by finding the FIB ADDRESS in the ADDRESS column, and read 
the corresponding file number in the SG column, 

4) Enter FILE < number > to see the File Information Block for the file. 

5) The I/O Descriptors are found within the File Information Block. 

4. If a file has not been opened on the unit assigned to that device, the unit is not connected 
to a job in the mix. 

1) The I/O descriptors are found in the Unit Test Descriptor chain at the end of the lOAT. 

2) Note that these are the only I/O descriptors in the Unit Test Descriptor chain that are in 
a defined state at the time of the system memory dump. 

For further information, refer in this manual to appendix F, Input/Output Operations, and to I/O 
Subsystems in section 2, System Elements. Also see section 6, I/O Subsystems and Device Controls, 
in the B 1870/B 1860 Systems Reference Manual. 
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APPENDIX A 
SYSTEM/IDA EXAMPLES 

A sample analysis of a system memory dump using the SYSTEM/IDA program is presented in the 
following pages. A system memory dump operation was performed by entering a DM system command 
with the DBUG system option set. The execution of the SYSTEM/IDA program, the entry of various 
SYSTEM/IDA commands that display the state of the system at the time of the dump, and the corre- 
sponding output are shown and described. 

EXECUTING THE SYSTEM/IDA PROGRAM 

The following analysis of a system memory dump was performed at a remote terminal that was signed 
on to the SMCS program when the EXECUTE system command was entered. 

The SYSTEM/IDA program opened a remote file. While that file was open, messages that did not 
begin with the signal character were routed to the SYSTEM/IDA program. Messages beginning with 
the asterisk (*) signal character were routed to the SMCS program. 

After the remote file was opened, the program displayed the message "--Ready for input (type HELP 
for help) ~" and waited for a SYSTEM/IDA command. The command entered, OPTION LIST, caused 
the list to appear in a printer backup file. 

EX SYSTEM/ 1 DA 

SYSTEM/IDA =1900 BOJ. PP^i*, MP=if TIME -13:19:31.7 

REMOTE FILE OPENED BY "SYSTEM/IDA", SIGNAL = * 

-- Ready for input (type HELP for help) --" 
OPTION LIST 

Options enabled: LIST ARRAYLIMIT •= Gk 



GETTING THE DUMPFILE 

The SYSTEM/IDA command GET SYSTEM/DUMPFILE causes the SYSTEM/IDA program to open 
the SYSTEM/DUMPFILE file for analysis and to display general system version information. This 
dump file resides on the DL DUMP system command's designation pack. Therefore, the ON keyword 
followed by a pack-id must be used when the SYSTEM/DUMPFILE file is not on the system pack. 
Refer to the B 1000 Systems System Software Operation Guide, Volume 1, for more information about 
the DL command. 

The information displayed includes the date and time the system memory dump operation was per- 
formed, the host name of the system, the version and compile date of the SMCP, and the contents 
of the L, T, X, and Y registers. The contents of the registers are decoded. 
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MCP STATUS 

In this example, the SMCP was running (NOT QUEUED) because it was processing the DM system 

command. If a CLEAR/START system memory dump operation had been performed, the contents 
of the L, T, X, and Y registers would have appeared on this screen. 

Example: 

GET SYSTEM/DUMPFILE 

System dumpfile title = SYSTEM/DUMPFILE 
11/05/8i» 12:37:38.6 :Date of dump 

"PAASSBPC" :HOSTNAME 
MCP VERSION - MARK 12.0.00 (10/30/8i») 
PSEUDO MEMORY SIZE - 2097152 BYTES . 
MCP I I :MCP NAME 
MCPII/MICRO-MCP :MICR0 MCP NAME 
SDL2/INTERP : I NTERPRETER NAME 

GISM03 :GiSMO NAME 
SYSTEM/INIT : INITIALIZER NAME 

*** MCP - MCPl I *** 

Job queue: NOT_QUEUED 

Job status: Executing 

MCP: Next S-op at P« 1,S= O.D- 2896 « @00B50@ 

Options enabled: LIST ADDRESSES ARRAYLIMIT « 64 

~ End GET. 

HELP COMMAND 

The HELP command displays the list of available commands or the syntax of a specific command. 
Example: 

HELP 
Help: 

'HELP' followed by a command will show the syntax for that command. 

Commands are: 

?BRK BYE DATA ?DP ENVIRONMENT ESN 

FILE FIB FPB GET IPC HELP LAYOUT MEMORY OPTION PPB PRINT 

RSN SMACHINE SPAD 

The following commands are not available in program dumps: 

BNA CHANNELS CODE CSV DCH DFH DISK DMS ERRORTABLE HINTS INTERPS I 

JOB LINKS MCP MPB NAMETABLE ODT PACKS PM PSR QUEUES STATE TAPE TR 

Lengthy output is written to a buffer that may be SCROLLed. 

Scroll commands are line numbers and: + - . $ 

The ?BRK command will terminate an endless loop. 

HELP SW or HELP SWITCHES will explain IDA's program switches. 

The manual gives the complete command semantics. 

Current level = 12.0, patch 0, compiled on 11/09/84 04:30 PM 

—END HELP. 
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ODT QUEUE 

The ODT command displays the most recent entries in the ODT queue. These are the entries at the 
end of the queue. All other SYSTEM/IDA commands display entries from the beginning of their corre- 
sponding data structures, with the exception of the TRACE command. 

In the following example, the date field which normally appears on the left side of the output has 
been deleted to facilitate getting the example on the page. The last entry in the list shows the DM 
system command that caused this system memory dump. 

Example: 



ODT 



16:26:46.0 
I6:26:it8.0 
16:26:54.5 
16:26:54.5 
16:26:54.8 
16:27:01.0 
16:27:08. 9 
16:27:12.8 
16:27:13-7 
16:27:18.5 

16:27:21.9 
16:27:23.3 
16:27:23.3 
16:27:23.5 
16:27:23.7 
16:27:31.1 
16:27:31.5 
16:28:09.5 
16:28:18.7 
16:28:24.1 
16:28:29.2 
16:28:44.7 
~ End ODT 









I 
I 














RMT 
ODT 
ODT 
ODT 
ODT 
ODT 
ZIP 

QUEUE; 



ODT 
ZIP 

RMT 

RMT 



IF 
TO 



INCORRECT 



12/15/83. 

% (ODT) SYSTEM/ARCH =1795 PLEASE STOP 

% (ODT) SYSTEM/ARCH =1795 ENTER PACKS 
ARCHIVE WHEN ACCEPT APPEARS 

CANDE =1044 S/ (DAN)/QRSTREAM REPLACED 

(ODT) SYSTEM/ARCH -1795 ACCEPT. 
1795AX DB 
REDB/ARCHIVE/FINDPACK 

DB/ARCHIVE/FINDPACK REMOVED 

(SYSTEM/IDA) SYSTEM/IDA =1784 5/ (SYSTEM/I DA) /DWHl 
RELEASE 

(SYSTEM/IDA) SYSTEM/IDA =1784 EOJ. TIME= 16:27:21.7 

% (ODT) SYSTEM/ARCH =1795 ENTER SPECS: SPAN 
INCL SELECT TYPE EXCL 

% (ODT) SYSTEM/ARCH -1795 FOR DB PACK 

(ODT) SYSTEM/ARCH =1795 ACCEPT. 

C0B0L74 : *NOTITLEO =1793 EOJ. TIME - 16:27:31.0 



S 
SELECT 



1795AX 

1795AX 
1795AX 
1795AX 
1795AX 
QU SMCS/MCPQ 
861 lines - 



CARDS 



LS SZ 9 RR 1 US SYSTEM/ 1 DA DM 
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MCP ANALYSIS 

The next two examples show the SMCP activity between the time the DM system command was entered 
and the time the contents of memory were written to the SYSTEM/DUMPFILE file. The first example 
shows the flow of control, and the second example shows an important data structure for dumping 
system memory. 

MCP Layout Summary 

The MCP layout summary shows the history of MCP procedure calls. In the example that follows, 
the global procedure called procedure GET SET ^GO, which is where the MCP waits for some- 
thing to do. GISMO activated the MCP to check a communicate message because a system command 
was zipped. The control card driver was called to decode the command and discovered the command 
began with the letter D. The command turned out to be a command to dump the system state. A proce- 
dure was then called to build the disk I/O descriptor (MDD) of the MCP and wait either for 30 sec- 
onds to elapse or for the operation to complete. The last procedure dispatched the MCP disk descriptor 
to GISMO. 

Example: 



LAYOUT SUMMARY 








Frame Kind N 


ame 


Next op at: 




Global 




P= 0,S= 0,0= 


212 


1 Proc 


GET SET GO 


P= 1,S= 0,D= 


116232 

103344 

4512 


2 Proc 

3 Proc 


CHECK COMMUNICATE MESSAGE 
ZIPP 


P- 1,S= 0,D= 
P= i»,S=ll.D= 


4 Proc 


CTRL CARD DRIVER 


P=31,S= 8,D= 


18012 


5 Proc 


D ~ 


P»3US= 2,D= 


19024 


b Proc 


DUMP SYSTEM STATE 


p=n,s= 3.D= 


2^896 


7 Proc 

8 Proc 


BIOAW 


P= 1,S= 0,D= 


INITIATE 10 


P= 1,S= 0,D= 


2896 


-- End LAYOUT 


SUMMARY — 
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MCP Layout Frame and Variable 

The LAYOUT VAR MDD command displays the disk descriptor (MDD) of the MCP. This descriptor 
is in frame 0, the global procedure. 

In the example that follows, descriptor bit 1 is OFF and descriptor bit 2 is ON, indicating the descrip- 
tor was initiated by GISMO to the disk control and that the operation is in process. When the COM- 
PLETE bit is OFF, the meaning of the following bit changes from EXCEPTION to INITIATED. The 

OP_CODE and UNIT fields specify a write operation to unit 0. The BEGIN and END ADDR fields 

specify that the write operation is to take data from memory address through memory address 

@FFFFFF@. The DISK ADDRESS field specifies that the data is to be written to disk sector 

@047383@. The PORT and CHANNEL fields specify the descriptor is for port 7 channel 9. 



Example: 



LAYOUT VAR MDD 

Frame 0; Next S-op at P«= 0,S= 0,D= 212 = @000DU@ 
— Layout of variable MDD 
Global frame 
Loc3 1b* 

MDD. ACTUAL END [FD81E4] = @FD7FA0@ {I661328O) 

RESULT~[FD8lFC] = @520E09@ (53775^5) 

BIT 1 2 [FD8IFC] ■= 1 

COMPlITE [F081FC] = FALSE 

EXCEPTION [FD8IFD] = TRUE 

INT BITS [FD82OB] = 

INTlRRUPT rFD820B3 = FALSE 

HI INT [FD82OC] = FALSE 

LIFTK CFD82143 = ©FDBFFFg (16629759) 

OP [FD822C] = ©400000® (419^304) 

OP CODE [FD822C] = 2 

UNTT [FD82itO] = 

BEGIN [FD82ifit] = 

END ADDR [FD825C1 ■= gFFFFFF® (16777215) 

DISK ADDRESS CFD8274T = @0it7383@ (291715) 

M EVENTS [FD828C] «= 8 

M~EVENTS IOC [FD828C] - FALSE 

M~EVENTS~SI0C [FD828D] = FALSE 

M~EVENTS~INT M [FD828F] = FALSE 

M EVENTS S IRT SENT rFD8290] = TRUE 

M EVENTS_M INT SENT LFD829IJ = FALSE 

M EVENTS IRT S CFD8293] = FALSE 

M^P 10 [70825^3 = @000A@ (10) 

FIB ADDR " 

FIB LINK 

BACK LINK CFD82Dlt3 = @FDA11F@ (l662l855) 



^0825^3 = @000A@ (10) 
[FD82Ait] >= 
CFD82BCJ = @FD80E5@ (16613605) 



PORT CHAN LFD82ECJ = @79@ (121) 
PORT [FD82EC3 = 7 
CHANNEL [FD82EF3 = 9 
BEEN THRU ERROR [FD82F33 = FALSE 
■- End LAYUUT Frame 0; 35 lines — 
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DISK DESCRIPTOR CHAIN 

The DISK command displays the disk descriptor chain and shows the disk descriptor of the MCP, 
which is always in the second entry immediately following the system pause descriptor in the first entry. 
These descriptors are also found in a layout of MCP frame zero, with the variable names MDD and 
SPD. 



The disk descriptor of the MCP shows the same information that was displayed by the LAYOUT 
VAR MDD command. It describes a write operation to port 7, channel 9, unit 0, disk sector 
@047383@, beginning at memory address and ending at memory address @FFFFFF@. 

Example: 
DISK 



RESULT 

DESCR 

ADDR 



*** DISK DESCRIPTOR CHAIN *** 



ACTUAL 
END 



RESULT 
DESCR 



LINK 



10 OP BEGIN END 



DISK 



ID 
MCP 
10 FIB 



FDAllF 
FD81FC 

.. M 
FDBFFF 

.. M 
FD8CitU 

.. M 
FD2E1U 

.. M 

FBEA57 

.. M 
F32DBF 

.. M 
F9329(5 

.. M 
F8E48F 

.. M 
FB962I 



FD7FA0 
EVENTS ■ 

FC80EA 
EVENTS ■' 

EVENTS ■■ 
26C4FB 

EVENTS ■ 
6BB79D 

EVENTS ■■ 

mhsi 

EVENTS ' 
7D2A6A 

EVENTS 
F8EB27 

EVENTS 
6BB7DD 



000000 

520E09 
= @08@ 

800080 
= @C0@ 

I2OFO9 
= (3080 

800080 
= %Z0& 

800080 
= @CO0 

800080 
= @C0@ 

800080 
= @C0@ 

800080 
= @CO0 

800080 



FD81FC 
FDBFFF 

FD8ciic' 

FD2Ei6' 

FBEA57 

F32DBf' 

F93296' 

F8Eii8F' 

FB9622' 

fdaiIf* 



81»0000 
itOOOOO 

PORT = 
ItOOOOO 

PORT ■- 
900005 

PORT = 
000000 

PORT = 
000000 

PORT = 
400000 

PORT = 
000000 

PORT = 
400000 

PORT - 
000000 



000000 ffffff 047383 

■- 7. CHANNEL = 9 

FC7FFE FC8OEA 041 14E 

■ 7. CHANNEL = 9 



■ 7. CHANNEL = 
26B263 26C4FB 

■ 7, CHANNEL = 
6BB64D 6BB79D 

7, CHANNEL = 
F32EB7 F33457 

7. CHANNEL •= 
7D0ECC 7D2A64 
'■ 7. CHANNEL = 
F8E587 F8EB27 

■ 7. CHANNEL = 
6BB64D 6BB7DD 



O378D3 

9 

0000F3 

9 

O3DD5O 

9 , 
01AF43 
9 
001B23 

0255D8 



10 

18 FD2581 
n 
5 FD2581 

24 FBE88E 

F3298F 

5 F92A01 

F8E05F 

24 FB9459 
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COLD START VARIABLES 

The CSV command displays the first page of the cold start variables. The following example illustrates 
the cold start variables for a specific system. 

Example: 



CSV 



*** COLD START 








@F2000008A@ 



eFoooooe 



225 
@F 20047383® 
157286l»0 
TRUE 
TRUE 
TRUE 
TRUE 



18650 



@000000000@ 

@F2000FABA@ 



VARIABLES *** 
:CS INTERP 
: CS~MCP 
: CS~G I SMO 
:CS~INIT 
:CS MICRO MCP 
:CS~C0NTRIJLLER 
: CS"MCS 
: CS~ODT 
:NARE TABLE 
iINTERP Die ENTRIES 
:CS SiZl ~ 
:DUHP FILE 

:csv rold start level 
:l6i Name Table ~ 
:l10~0 new sys disk tables 

:L10~0~NAMr TA^LE ~ 
:L11~0"NAME~TABLE 

rGlS^MlJ TRA^E FLAGS 

:DUMP flLE STZE 

iCORRlCTABlE ERROR TABLE LEN 

:MPF TABLE - - - 

:LOG"MIX INFO 



TERMINATING THE SYSTEM/IDA PROGRAM 

Execution of the SYSTEM/IDA program is terminated by entering the BYE command. 

BYE 

-END OF SESSION - 
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APPENDIX B 
HARDWARE ORGANIZATION 



An understanding of the paths available for data flow to and from I/O devices, the processors, and 
memory can greatly facilitate the analysis of system memory dumps. 

Figure B-1 shows a B 1955 single processor system. The processor is connected to memory through 
port 0, the host adapter, and the memory base unit, and is connected to the I/O devices through port 
7, the I/O subsystem, and I/O controls. Single-unit channels require I/O controls only; multiple-unit 
channels include electronics controllers. A single-line control may be attached on channel 13 of the I/O 
subsystem. 

Figure B-2 shows a B 1985 dual (master and slave) processor system. As in figure B-1, the master pro- 
cessor is connected to memory through port and to the I/O devices through port 7, the I/O subsys- 
tem, and I/O controls for single unit channels and electronics controllers for multiple unit channels. 
Note that both NRZ and PE magnetic tape units can be attached to the I/O subsystem on channels 
11 and 12. 

The slave processor connects to memory through port 1, a host adapter, and the memory base unit. 
Port 2, from the host adapter, connects the slave processor to a multiline control that services up to 
15 datacomm adapters and the associated terminals. 

Figure B-3 shows a B 1990 single processor system. The ODT is connected directly to the processor, 
and there is no host adapter. The disk subsystem controller on channel 9 includes a printer control 
that services one line printer through channel 8 and up to 8 disk pack units. The magnetic tape control 
needs no electronics controller; it accepts one tape unit. The multiline control is required and may be 
connected on either port 1 or port 3. 

Figure B-4 shows a B 1990 dual processor system. The slave processor is connected through port 2 to 
the memory base unit and memory. The disk subsystem controller on channel 9 includes a printer con- 
trol that services one Une printer through channel 8 and up to 8 disk pack units. The magnetic tape 
control has a master electronics controller with the provision for up to 8 tape units. 
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Figure B-1. B 1955 Single Processor System 
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Figure B-2. B 1985 Dual Processor System 
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Figure B-4. B 1990 Dual Processor System 
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APPENDIX C 
PROCESSOR ALLOCATION 



GISMO controls all processor allocation. It has only one entry point. The address of the entry point 

is in the HINTS.MASTER GISMO field. The instruction at the entry point transfers control to the 

ENTER.GISMO module. 

The ENTER.GISMO module first tests for an out-of-bounds memory access or a memory parity error. 
If neither condition exists, control is transferred, based on a value passed in the X-register, to one 
of the procedures listed next and described in the paragraphs that follow. 

HANDLE. COMMUNICATE 

HALT. AND. EXPLAIN 

DISPATCH. THRU. CHANNEL. TABLE. AND. CLEAR. EXCEPTION. IDLE 

D I SPATCH .THRU . CHANNEL .TABLE 

MCP. FETCH. INTERRUPT 

HANDLE. INTERRUPT 

MMCP. RETURNING. CPU 

MCP. SAVE. IN. IQ 

ENABLE . D I SABLE . I NTERRUPTS 

START. SCHEDULER 

INTERP.OR.MCP.TRACE 

COMMUNICATE. WITH. GISMO 
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HANDLE.COMMUNICATE 

A communicate message has been sent from a job. The format of the communicate message is con- 
tained in the programmatic description of the environment structure nucleus. 

The following is a programmatic description of the communicate routing process. The process is based 
on the contents of the type bits in the communicate message. 

Stop accumulating processor time for the job. 
If the type indicates a program internal interrupt then 
If the interrupt number is 60 then 
A job is giving up control. 
Mark the job in the Ready queue. 
Run the scheduler. 
If the interrupt number is greater than 55 then 
Mark the job in the SMCP communicate queue. 
Run the scheduler. 
If the interrupt number is 18, 53, or 55 then 

One of the following errors is being reported: 
A write beyond the job's base limit area. 
A cassette data error. 
A read or write out of physical memory. 
If the reporting job is not the SMCP then 

Mark the job in the SMCP communicate queue. 
Run the scheduler. 
Else (the reporting job is the SMCP) 

Move one of the following values to the L-register: 
@0D0012@ 

@OD0053@ 
@OD0055(a 
Halt the processor. 

When the type does not indicate a program internal interrupt, the run structure for the job is examined 
before the communicate verb is used to index into the communicate splitter mask. 

If the job is currently active in a use routine then 

Run the MMCP to interpret a pocket select communicate. 
If the type does not indicate a standard communicate then 
Mark the job in the SMCP communicate queue and then run 
the scheduler. 
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The type indicates a standard communicate. If the verb is @800@ or greater, the communicate is a 
GISMO communicate. Following is a description of the GISMO communicate in programmatic terms. 

If the job does not have the ESN control state bit set then 

Discontinue the execution of the job. 
If the verb is @801§ then 

Place the job in the Wait queue. 
If the verb is @803@ then 

Perform a Adjust MCP Interpreter operation. 

(Obsolete. Used on B1720 systems to transfer control to the 

SMCP interpreter after adjusting control memory management 

fields.) 
If the verb is @80't@ then 

Perform a Find Window operation. 

(Used to select an area of memory to satisfy a request for 

S-memory) 
Else 

Move @OD0039@ to the L-register. 

If the verb is 47, perform a complex wait operation. Build a hst of absolute memory addresses, each 
pointing to a Boolean. If any of the Booleans is TRUE or becomes TRUE, the job is put into the 
queue specified by the next Q. If all the Booleans are FALSE, put the job into the WAIT.Q. 

If the verb is 40, do a DC INITIATE. 10. 

If the verb is 13, perform one of the following operations: 

Data Overlay for SDL or SDL2 

DMS Read 

DMS Lookahead Read 

DMS Write 

DMS Audit Write 

Direct I/O 

Use the verb to index into the communicate spUtter mask. The mask is a series of 8-bit fields specifying 
where the communicate operation is to be routed. Based on the value returned, one of the following 
actions takes place. 

Value = 4 

Mark the job in the SMCP communicate queue. 
Set the SMCP Communicate Queue Event bit. 
If the SMCP was in the Wait Queue then 

Mark the SMCP in the Ready Queue. 

Run the scheduler. 

Value = 5 

If there is a service request then 
Handle the service request. 
Run the MMCP. 

Value = 2 

Switch between the primary and DMS environments. 

Value = 3 

Switch between the primary and IB ASIC environments. 
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HALT.AND. EXPLAIN 

An invalid entry parameter was passed in the X-register. The system halts with L = @0D0042@, and 
the T-register contains the limit register of the program that passed the invalid parameter. 

DISPATCH.THRU.CHANNEL.TABLE.AND.CLEAR.EXCEPTION.IDLE 

Clear the EXCEPTION.IDLE bit in the channel table then perform DISPATCH.THRU.CHANNEL-- 
.TABLE. 

DISPATCH.THRU.CHANNEL.TABLE 

An I/O descriptor has been dispatched. If the I/O channel is not busy, and not idle because of an 
exception, the descriptor is sent to the I/O control. 

NOTE 
Only channels that cannot continue after an exception, such as the card read- 
er or the printer, will have the exception idle bit set. If the channel is busy, 
the descriptor is sent later. 

MCP.FETCH. INTERRUPT 

The address of an I/O result descriptor is returned to the MCP. 

HANDLE. INTERRUPT 

Interpreters typically consist of a loop that (1) fetches, (2) decodes, and (3) executes an instruction. 
A test is made at the beginning of the loop for any interrupt condition. The processor hardware assists 
here by ORing all interrupt conditions into a single bit, called ANY. INTERRUPT, which can be tested 
in a single microinstruction. When such a condition exists, control is transferred to the HANDLE. I- 
NTERRUPT procedure. The following is a programmatic description of the procedure. 

If a memory read data error or a write beyond the limit register error occurred then the following 
action is taken: 

Read and clear the error log register. 

If an uncorrectable memory error occurred then 

Move @0D005if@ to the L-register. 

Halt the processor. 
If a single bit error occurred then 

Make an entry in the Correctable Error Table. 

Make an entry in the Interrupt queue. 

Set the SMCP interrupt queue event. 

If the SMCP was in the Wait queue then 

Mark the SMCP in the Ready queue if the SMCP was waiting 
on that event. 
If a cassette data error occurred then 

Return with 53 in the L-register. 
If a read or write beyond the MAXS register occurred then 

Return with 55 in the L-register. 
If a write beyond the limit register occurred then 

Return with l8 in the L-register. 
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The following describes in programmatic terms the beginning of the HANDLE. INT. LOOP procedure. 

If the console halt bit is set then 
Wait for l/Os to complete 
Move ©0D00108 to the L-register. 
Halt the processor. 
Reset the service request bit. 
If the port interrupt bit is set then 

Handle one of the following port interrupt conditions: 
A message from the master processor to the slave 
processor to do one of the following: 

Purge the slave processor cache memory. 
Block the scheduler from running a specific job 
or from running any jobs on the slave processor. 
Unblock the scheduler from running a specific job 
or from running any jobs on the slave processor. 
Set the slave processor console interrupt flag. 
A message from the slave processor to the master 
processor to perform a DISPATCH. THRU. CHANNEL. TABLE 
operation. 

A message from the multiline control that an I/O 
operation completed. 
Transfer control to the beginning of the HANDLE. I NT. LOOP 
procedure. 
If the service request bit is set then 

An I/O control is requesting service by the master processor 
for one of the following reasons: 
To transfer data. 

Because an I/O operation completed. 
Because a seek operation completed. 
Transfer control to the beginning of the HANDLE. I NT. LOOP 
procedure. 
If the timer interrupt bit is set (occurs every tenth of a second) 
then do the follov^ing: 

Test for dual processor timeout. 

Leave message for scheduler that timer interrupt occurred. 
Move the time register to HINTS.TIME_MARK. 
Add 1 to HINTS.SYCOUNTER. 

If the memory management sampling interval has elapsed, 
perform the thrashing detection logic to conditionally 
set the HINTS. MEM SWEEP PENDING bit. 

Transfer control to the beginning of the HANDLE. INT. LOOP 
procedure. 
End of the HANDLE. INT. LOOP procedure. 

If no Force Reschedule bit set or interrupts are disabled then 
Allow the interrupted job to resume processing by returning 
with in the L-register 

Else 

Require the interrupted job to save state and give up control 
to the scheduler by returning with 60 in the L-register. 



1152055 C-5 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Processor Allocation 



MMCP.RETURNING.CPU 

The MMCP is returning control of the processor for one of the following reasons: 

1. The MMCP completed tanking (saving reader/sorter data in a buffer), and has set up a job 
for running the use. routine. In this case, reinstate the job to run the use routine. 

2. The MMCP completed a communicate operation for a job. If no Force Reschedule has oc- 
curred then reinstate the job, otherwise, mark the job in the Ready queue and run the sched- 
uler. 

3. The MMCP needs help from the SMCP before it can complete a communicate operation for 
a job; for example when a logical write operation is in process and a new disk area is required. 
In such cases, mark the job in the queue specified by the MMCP. Run the scheduler. 

4. The MMCP has built a wait list of events. In this case, if any of the events were TRUE, then 
put the job in the queue specified by the next queue ID; otherwise, put the job in the 
WAIT_Q. Run the scheduler. 

MCP.SAVE.IN.IQ 

This entry point is not used. 

ENABLE.DISABLE.INTERRUPTS 

The DISABLE INTERRUPTS field in the run structure of the currently running job is decremented 

or incremented. Interrupts are enabled if the new value is zero; otherwise they are disabled. If inter- 
rupts become enabled, the service request bit is set. 

START.SCHEDULER 

This is the initial entry point from SYSTEM/INIT at CLEAR/START. If DMS is not permitted to 
run on the slave processor, a bit in HINTS is set to remember this. This procedure then transfers con- 
trol to the scheduler procedure. Since a CLEAR/START has just been performed, the scheduler will 
find the SMCP ready to run. 

SCHEDULER 

The scheduler is the procedure that allocates the processor to the SMCP, the MMCP, and the jobs 
in the mix. The following is a programmatic description of the scheduler. 

If any interrupts are outstanding then 

Call the HANDLE. INT. LOOP procedure to handle all outstanding 
interrupts. 

If running on the master processor then 

If a timer interrupt has occurred then 

Run the memory link sweeper if the MPRI system option 
is set and the HINTS.MEM_SWEEP_PENDING bit is set. 
Run the timer dispatch pFocedure (every l6th timer 
interrupt) to initiate test and wait operations 
on idle disk and tape controls to see if any 
disks or tapes have been mounted or dismounted. 
Move the SMCP and any job in the mix whose wait time has 
expired to the queue specified in its RS_NEXT_Q field. 
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If the MMCP high priority interrupt queue event is TRUE (used for 
reader/sorter operations; then 

Run the MMCP. 
If the SMCP is in the Ready queue and the SMCP interrupt queue 
event i s TRUE then 

Run the SMCP. 
If the SMCP is in the Ready queue then 

If the schtiduler is blocked then 
Run the SMCP. 

If it is time for the SMCP to do its housekeeping then 
Run the SMCP. 

Set a flag to note that the SMCP was in the Ready queue. 
Else 

If the scheduler is blocked then 

Idle and wait for a any interrupt. 

Select the highest priority job in the mix which is in the 
Ready queue, MMCP communicate queue, SMCP communicate queue 
(if the SMCP was in the Ready queue), or the I/O complete queue. 
If more than one job of the same priority group Is available, 
select the job which follows the last job run at that priority. 
(The last job run within a priority group has the RS_LAST_TOP 
bit set.) 

If no job Is selected then 

If the SMCP was not in the Ready queue then 
Idle and wait for any interrupt. 

Run the SMCP. 
If the job selected was In the SMCP communicate queue then 

Run the SMCP. 
If the SMCP was in the Ready queue and its CPU priority is 
greater than or equal to that of the selected job then 

Run the SMCP. 

If no job Is selected then 

Mark the job as Not queued. 

If the job had been in. the MMCP communicate queue or the I/O 

complete queue then 

Run the MMCP. 
Reset the previous RS LAST TOP bit; set the current 
RS^LAST_TOP bit. 
ReTnstate the selected job. 

Else (running on the slave processor) 

If the scheduler is not blocked from running on the 
slave processor then 

Select the highest priority job in the mix which Is In the 
Ready queue or the IOC queue and Is not blocked. 
If more than one job of the same priority group is available, 
select the job which follows the last job run at that priority. 
If a job is selected then 

Mark the job as Not queued. 
Save the address of its run structure In 
DCPU. SLAVE. LAST. REIN. 
If the job was in the IOC queue then 
Run the MMCP. 
Reset the previous RS LAST TOP bit and 
set the current RS_LA^T__.TOF bit. 
Reinstate the selected Job. 
Else 

Go idle and wait for a timer interrupt. 
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INTERP.OR.MCP.TRACE 

This procedure is called to make an entry into the GISMO trace table. 

COMMUIMICATE.WITH.GISMO 

The various GISMO functions that are performed at this entry point are listed in the following 
paragraphs. 

Schedule Operations 

Included in the GISMO functions are the following operations that affect the scheduler. 

INTERRUPT. SLAVE 

Dispatches a port interrupt to the slave processor to set the slave processor console interrupt flag. 

Q. OUT. TOP 

Locates the highest priority program in a specified queue, For example, when the SMCP communicate 
event is TRUE, the SMCP performs a COMMUNICATE.WITH.GISMO operation to locate the high- 
est priority program in the SMCP communicate queue. 

MARK. IN. Q 

Moves a job to a specified queue. For example, when one of the events of a job in the Wait queue 
occurs, a MARK. IN. Q operation is performed to move the job to the queue specified in the 
RS_NEXT_Q field. 

HANG. PROGRAM 

Places the SMCP or a job in the mix in the Wait queue. For example, the SMCP can hang on TIME 
or I/O COMPLETE. The SCMP and jobs in the mix can hang on a list of events specified in a WAIT 
statement. 

CAUSE. PROGRAM 

An event has occurred; this operations locates and wakes up all programs waiting on the event. Using 
the address of the event, CAUSE. PROGRAM looks at the SMCP and all jobs in the mix. For each 
program waiting on the event, it reports the event and checks intervention as follows. 

If the RS_REPORT__EV_INX bit is TRUE, the result of the event in the 
ES_REINSTATE_MSG_PTR is reported. If the RS_INTERVENTION bit is TRUE, a master pro- 
cessor rescheduling operation is forced and the program is moved to the SMCP communicate queue; 
otherwise, a master and slave processor rescheduling operation is forced and the program is moved 
to the queue specified in the RS NEXT Q field 

BLOCK. SLAVE 

Dispatches a port interrupt to the slave processor to block the scheduler from running a specific job 
or from running any jobs on the slave processor. 
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UNBLOCK. SLAVE 

Dispatches a port interrupt to the slave processor to unblock the scheduler from running a specific 
job or from running any jobs on the slave processor. 

REHANG. PROGRAM 

Checks the event list for a program to see if any events on which it was waiting have occurred. If 
an event has occurred, it is reported and intervention is checked, as specified above in the description 
of CAUSE.PROGRAM. 

PURGE.CACHE.MEMORY 

Dispatches a port interrupt to the slave processor to purge the slave cache memory. 

This is requested by the SMCP when microcode has been overlaid to prevent the slave from executing 
code that is no longer present in S-memory. 

UPDATE.LAMPS 

Updates the information in the 24 main exchange lights on the system console for system performance 
monitoring. 

MEMORY.MANAGEMENT.FUNCTIONS 

If the MPRI and THR system options are set, the HINTS.OVERLAY.COUNTER is bumped. 

MAKE.TRACE. ENTRY 

Makes an entry into the GISMO trace table. 

REWIND. CASSETTE 

Rewinds the console cassette tape drive. 
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The major data structures used by the SMCP program to keep track of its own state and the state 
of the user tasks in the mix are delineated in this appendix. These structures include the cold start 
variables, the SMCP global variables (HINTS), the run structure nucleus (RSN), and the environment 
structure nucleus (ESN). 

SOFTWARE CONFIGURATION 

Figure D-1 shows how the SMCP locates the run structures and environment structures for the various 
tasks in the mix. The HINTS. FIRST_QUEUE field points to the run structure nucleus (RSN) for the 
first task in the mix. 

The RSN RS_Q_LINK field points to the RSN of the next task. The RSN RS_ENV_DIC field 
points to the environment dictionary. The RSN RS FIB DIC field points to the FIB dictionary. 

The environment dictionary points to the primary and secondary environment for the task and also 
contains processor times for each environment. The primary environment points to the code and data 
for the task. The secondary environment points to code and data of a process that performs system 
functions on behalf of the task. 

Following are the environment numbers and the use to which each is put. 

Environment 

The primary environment for the SMCP program and all tasks. 

Environment 1 

Not used. Reserved for future development. 

Environment 2 

A secondary environment for DMSII programs. 

Environment 3 

A secondary environment for IB ASIC programs. 

A page dictionary exists only for programs that page their code segments. A data dictionary exists only 
for programs that have paged data. BASIC, COBOL68 and FORTRAN are programs of this type. SDL 
and SDL2 programs with paged arrays use page tables within the program's dynamic memory. These 
tables are managed by intrinsics that use the data overlay communicate (type 13). 
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Figure D-1. Software Configuration 
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COLD START VARIABLES 

The cold start variables include information on the date, time, and the system options. A programmatic 
description follows. 

RECORD 1 PRO ARRAY BIT(l6) , 

2 PCU ~ BIT(12) , 

2 LABEL_TYPE BIT(2) , 

% « ANS I I 

% 1 » UNLABELED 

% 2 » BURROUGHS 
2 TRANSLATE BOOLEAN,* 0=EBCDIC 1=ASCII 

2 CLEAR_START BOOLEAN; 

CONSTANT MAX_SYSTEM_DISKS = l6; 

TYPE SYS_DISK_INDEX_TYPE = BITCt); % for indexes into CSV.SUS(SDl) 

RECORD 1 SYSTEM UNITS ARRAY BIT(l6), 
2 SYS PCU ~ ~ PCU LAYOUT, 
2 AVLlDISP B\Tlk)i 

%%%%%% CONSTANT CSV_SIZE; See the CONSTANT below the CSV record 

RECORD COLD START VARIABLES 

CLElR_STAlT_FLAGS RECORD 

% Add value in the field to the corresponding index." For 
% example, index into name table for the current network 
% controller is CONTROLLER_INDEX + CSV.CS_CONTROLLER. 
% See CM_GRINDER (mod 27). 

FILLER BIT (8), 

CS INTERP BIT (4) , 

% Which interpreter. 0=>l, 1=>IX. 
CS MCP BIT (4) , 

% Which MCP. 0=>M, 1->MX. 
CS GISMO BIT(4) , 

% Which Gismo. 0=>G, 1=>GX. 
CS INIT BIT (4), 

% Which Initialiser. 0=>N, 1=>NX. 
FILLER BIT(4), 

CS MICRO MCP BIT(4) , 

% Which iiiicro mcp. 0=>MM, 1=>MMX. 
CS CONTROLLER BOOLEAN, 

%TRUE=>CX, FALSE=>C is active. 
CS MCS BOOLEAN, 

%TlUE'=>MCX, FALSE=>MCS is active. 
CS ODT BOOLEAN, 

%TRUE=>0DX, FALSE=>0DT is active. 
FILLER BIT (5) 

END, 
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NAME_TABLE 




BIT (36). 


% Disk address of the 


name tabi 


e. 


INTERP Die ENTRIES 




BIT(24) , 
BIT(2M, 


cs sizr 




duHp file 




BIT (36) . 


CSV ZOID START LEVEL 




RECORD 


161 nTvme TAILE 




BOOLEAN, 


L10"0 NEW SYS DISK 


_TABLES 


BOOLEAN, 


L10~0"NAMr TABLE 




BOOLEAN, 


Lll NAME TABLE 




BOOLEAN, 


F 1 LIeR 




BIT (20) 


END, 






GISMO TRACE FLAGS 




RECORD 


[CHANNEL^ 




BIT{15) 


1 CHANNEL 




(15) BOOLEAN], 


GISMO 




BOOLEAN, 


PORT 




BOOLEAN, % 16. 


USER 




BOOLEAN,* 17 
BOOLEAN,* l6 




mcp 






SMCP 




BOOLEAN,* 19 




GISMO FREQUENT 




BOOLEAN,* 20 




TIME STAMP 




BOOLEAN,* 21 




DATA TRANSFER 




BOOLEAN,* 22 




TABLl LOCKED 




BOOLEAN * 23 




% This is used 


by the Gismo trace mechanism so that a dual 


% processor system is correctly traced. 






END, 


DUMP FILE SIZE 




BIT(16),„ 


CORRICTABUE ERROR TABLE LENGTH 


BIT (16),* kO + 32*#ENTRIES 
BIT (36), 


MPF TABLE 




LOG MIX INFO 




BIT(36), 
BIT (36) , 


DISK AVffiL 




DISK~DI RECTORY 




BIT (36) , 


TEMP TABLE 




BIT (36), 


SY DiTE 




RECORD * FOR SYSTEM/ODT RECORDS 


~SY DAY 




BIT (5), 

BIT a) . 


SY MONTH 




SY~YEAR 




BIT(7) 


END, 






SY JDAY 




BIT (9), 


SY~T 1 ME 




RECORD 


~SY HOUR 




BIT (5). 
BIT(6 , 


SY MIN 




SY SEC 




BIT 6) , 
BIT (It) 


SY lOTHSEC 




END, 






SY 12H0UR 




BIT (5), , ^ 


SY~DAYNAME 




CHARACTER (9 , 


SY"MERIDIAN 




CHARACTER (2) , 


SYSTEM OPTIONS 




RECORD 


LOG OPTION 




BOOLEAN, 


CHARGE OPTION 




BOOLEAN, 


LIB OPTION 




BOOLEAN, 


OPER OPTION 




BOOLEAN, 


TERM~OPTION 




BOOLEAN, 


TIME OPTION 




BOOLEAN, 


DATE OPTION 




BOOLEAN, 


CLOSr OPTION 




BOOLEAN, 


PBT OPTION 




BOOLEAN, 


PBD OPTION 




BOOLEAN, 


BOJ OPTION 




BOOLEAN, 


EOJ OPTION 




BOOLEAN, 


schH option 




BOOLEAN, 


LAB UPTION 




BOOLEAN, 
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RMOV OPTION 


BOOLEAN, 


DUMP OPTION 


BOOLEAN, 


ZIPP~OPTION 


BOOLEAN, 


MEM UPTION 


BOOLEAN, 


SWOl OPTION 


BOOLEAN, 


SW02~0PTI0N 


BOOLEAN, 


SW03 OPTION 


BOOLEAN, 


LTB TJPTION 


BOOLEAN, 


AMC^ OPTION 


BOOLEAN, 


FILirR 


BOOLEAN, 


TRMD OPTION 


BOOLEAN, 


DEBU(J OPTION 


BOOLEAN, 


DISP OPTION 


BOOLEAN, 


ODTL OPTION 


BOOLEAN, 


RMSG~OPTION 


BOOLEAN, 


SQRM OPTION 


BOOLEAN. 


COPY"OPTION 


BOOLEAN, 


BREL OPTION 


BOOLEAN. 


mprToption 


BOOLEAN, 


THRASHING OPTION 


BOOLEAN, 


FLMP OPT 1 UN 


BOOLEAN, 


VLCP~OPTION 


BOOLEAN, 


VLIO~OPTION 


BOOLEAN. 


F 1 LLIR 


BOOLEAN. 


WFL OPTION 


BOOLEAN. 


SWD option 


BOOLEAN. 


SWE_option 


BOOLEAN. 


SWF option 


BOOLEAN. 


F 1 LlER 


BIT (38) 


END, 




FIRST SCHED ENTRY 


BIT(36). 
BIT (36) . 
BIT (8) , 


FIRST WAITING SCHED 


MIX LTMIT 


SYSTEM UNITS 


RECORD 


SUS"(MAX SYSTEM DISKS) 


SYSTEM_UNITS_ARRAY 


END, 




MASTER lOAT 


DSK ADR, 


MASTER~DISK AVAIL 


DSK~ADR, 


NEXT LUG RETT 


DSK~ADR, 


LG STZE " 


WORU, 


NEXT ELOG 


DSK ADR, 


ELOG SIZE 


WORU, 


JOB No 


WORD, 


PBD NO 


WORD, 


ODT Q SIZE 


WORD, 


ctlUcK no 


WORD. 


LOG NO" 


WORD, 


QDISK 
tRage FPB 


DSK ADR, 
DSK ADR, 


AUTO HASK array 


RECURD % it OF 7 EACH=PRT PC 


AUTO MTfSK (k) 


BIT(7) 


END, 




AB NUMBER 


BIT (3)-.% NUM OF SYSTEM/BACKUPS 


PBP BLCKS AREA 


WORD, 


LG East aRea 


BOOLEAN, 


elUg_la5t_area 


BOOLEAN, 


dl backup~desl gnat ion 


NAME, 


ODT Q 


DSK ADR. 


PROTECTED UNITS 


REClJRD 


PRO ELlMENT (16) 


PRO ARRAY 


END, 
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SYS LOG NUMBER 


BIT(2i»). 
BIT(2M. 


JOB~ACCTlNG NUMBER 


SESSION NR 


BIT (16). 
BIT (36) .« WA! 


FILLER 


CSV NSEC DISABL THRASH FAULT 


BOOLEAN, 


CSVOVERlAY RATI 


BIT(6 , 
BIT (8) , 


CSVTHRASHIRG SENSITIVITY 


CSVHOSTNAME 


CHARACTER (17i 


NEXT HOSTNAME 


CHARACTER (17l 


SYSTlM PROGRAM PACK 


NAME, 


ERROR Rate addR 


DSK ADR, 


LOG MTX INFO SIZE 


BITll6), 
BIT (24), 


RIB~NUMlER 


d l_3unip_eles i gnat i on 


NAME; 



THE XM TABLE ADDR 



,% BNA. 



CONSTANT CSV SIZE 



TYPE_LENGTH (COLD_START_VARI ABLES) ; 



DECLARE CSV COLD_START_VARI ABLES REFERENCE; 
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HINTS 

The MCP global data is kept in a structure named HINTS. The data is used as a means of communica- 
tion among the SMCP, the MMCP, and GISMO. The HINTS structure also provides global storage 
for information that those programs need to save between the time periods they have control of the 
processor. 

The HINTS structure starts at memory address zero. The comment field immediately to the right of 
each variable declaration is the absolute address in hexadecimal of that variable. 

The following is a programmatic description of the HINTS structure. 

RECORD HINTS_RECORD 
%The order of the following field declarations and their address must 
%not be changed. The first data declaration must consist of this 
%record. 

%The first field is required by port interface hardware. Most of the 
%rest are for the system memory dump analyzer (SYSTEM/IDA), although 
%some fields are needed by gismo and the MMCP. 

%The first three fields are also used by clear start to keep the slave 
%out of harms way whilst initialisation is in process, and there are 
%insuff icient structures and code present to control it. The source of 
«clear start should be consulted for final details. However, the 
%memory (starting at address 0) is used lil<e this:- 

% 0005 % purge cache memory, so that the slave's code can be 
% I changed by the master. (This does not purge the 

« % master processor's cache - only the slave's.) 

% 94000000 % move 2k bit literal to the A register. The six zeros 
I % are changed (by the master) to the address of the 

* % scratch pad and A-stacIt dump routine. When finished 

* % the slave resets the literal to zero. 

I 000000 % initialised to zero by the master, but used as a 
% % parameter for master-slave communication. 

DISPATCH_W0RD BIT (024)% HEX 000 

% Reference address of I/O descriptor for dispatch. 
% For I/O initiate, the descriptor to be initiated. 
% Port devices yield address of I/O just completed. 
ADDR DP_PR0C2 BIT (024)% HEX OI8 

FILLlR BIT (024)% HEX 030 

MASTER_GISM0 BIT (024)% HEX 048 

% Entry point to gismo. Used by interpreters and MMCP during 
% transfer of control to gismo. 
L0CN_MAKE_MCP BE_HERE BIT (032)% HEX O6O 

% Code address of MAKE_MCP_BE_HERE. Set during initialisation and 
% never changes. Used by the SDL2 interpreter when a needed MCP 
% code segment is not in memory. The stacks are faked up so that 
% return from MAKE_MCP_BE_HERE returns to code as if the segment 
% had been present~all the time. 
NO SLAVE DMS BIT(001)% HEX O8O 

? 
% 
LOCN_INTERP_DICT BIT (024)% HEX 08I 

% Address of the interpreter dictionary. Used by Gismo when 
% transfer ing control to the MMCP or an interpreter. 
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Kl KO BiT(001)« HEX 099 

% 
NO REINSTATES BIT (001)% HEX 09A 

? Not used. Replaced by SCHEDULER BLOCK COUNT. 
FIRE UP_CONTROLLER BIT(OUl)% HEX 09B 

% ^et when the NDL network controller is required. Tested in the 

% outer loop. (To avoid calling program initiation inline and the 

% associated stack space requirements.) 
N SECOND_COUNTER BIT (002)% HEX 09C 

~% Count of number of passes through N SECOND. Every fourth 

% N-second (when = 0), update the colH start variables on disk. 

% Primarily to ensure that the system date and time are reasonably 

% accurate in the event of a system crash. 
, [ MCP_ESN_ADDR BIT (024)% HEX 09E 

% Address of the MCP's environment structure nucleus (ESN). 
! MCP_LIMIT B1T(024)% HEX 09E 

% Top end of MCP writeable memory. 



] 



LAST OVLY BIT(02it)% HEX 086 

% Points to the memory link of the most recently overlaid memory. 
MICR DEBUG BIT BIT(001)% HEX OCE 

% ~ ~ 
Q_NOT_LOCKED BIT(001)% HEX OCF 

% Event bit that is caused (set TRUE, and waiting processes 

% checked) when the queue subsystem is available. 

% Checked by SMCP and MMCP. 
DFH DIR_AD BIT(02it)% HEX ODO 

% Address of the disk file header (DFH) dictionary. See also 

% DFH DIR LTH. MPF DIR AD, MPF DIR LTH. 
AUTO GUiRD ~ ~ " BIT (003)% HEX 0E8 

% Used to control initiation of SYSTEM/BACKUP for autobackup 

% functions. 
FIRE SYSTEM_BACKUP BIT (003) % HEX OEB 

% When a clear start is not required, N second checks this field 

% and if non zero, initiates a copy of lYSTEM/BACKUP for 

% autobackup, and decrements the count. Thus the autobackups are 

% scheduled one per N-second, and the system is not overloaded. 
FOUND_BACKUP DESIGNATION BIT(001)% HEX OEE 

% DL BACKUP pack is alive and well and on the system. 
INTERRUPT DISABLE_BIT BIT(001)% HEX OEF 
TRACE_CONniTIONAL_HALTS BIT (001)% HEX OFO 

% SMCP conditional halts are to be entered into the gismo trace 

% table. 
TRACE HALTS SETTUP BIT (001)% HEX OFl 

RAM DISK DISABLED BIT (001)% HEX 0F2 

SYSTEM OVRLAY COUNTS BIT (024)% HEX 0F3 

FIRST_'i3UEUE ~ BIT (024)% HEX lOB 

% Address of the first user run structure nucleus (RSN) . The user 

% RSN's are a linked list ordered by processor priority. 
ADDR OF COLD START_VAR BIT (024)% HEX 123 , ^ 

% TfddFess of the memory copy of cold start vaiables (CSV) . 
ADDR OF INTERRUPT INFO BIT(024)% HEX 13B 

% Frior to 12.07 address of the interrupt queue header, and thus 

% the interrupt queue. 12.0 uses the hardware MAXS register to 

% find the interrupt queue, which is part of gismo's data area. 

% The interrupt queue is maintained by gismo. 

% The SMCP requests information from the interrupt message 

% queue by using the FETCH SDL2 verb. The SDL2 interpreter then 

% calls gismo with the relevant swapper value. 
FILLER BIT(003[| HEX 153 

IN CCD BIT(001)% HEX 15b 

5^TRUE => The MCP is perform! n a task in control card driver for 

% WFL. 
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ELOG FULL BIT(001)% HEX 157 

%TRUE => the ELOG is nearly full (or full). At the next N-second 

% pass, try to transfer the ELOG, and get more space. 

NON_RELEASE_MCP BlT(001)% HEX 158 

% The MCP sets this field when extra checking and debugging code 

% has been compiled into the MCP. Primarily intended for use by 

% plant personnel . 

% 

% 
GISMO LEVEL BIT(008)% HEX 159 

% ~ 
HI RESOLUTION_TiMER SET BIT(001)% HEX l6l 

^TRUE => special T/0 control (channel 15) for high precision 

% timings is present. Superceded by the TIME register on 

% M3 (BI86O) and later processors. 

PSR CHANGE_BIT BIT(001)% HEX l62 

%TRUE =>~pseudo readers should be examined for work at the next 

% N-second pass. 

RELEASE LEVEL BIT(008)% HEX I63 

% "" 

! MARK BIT(00lf)% HEX I63 

% 

LEVEL BIT (004)% HEX 16? 

% 

FIRST_LINK BIT(02i»)% HEX 16B 

% Address of the first memory link. 
MCP_TYPE BIT(00it)% HEX l83 

% Not used. 
SYCOUNTER BIT (020)% HEX I87 

% Time of day in tenths of a second. Maintained every timer 

% interrupt by gismo without requiring the running process to save 

% state . 
SY CNTR_MSK BIT (020)% HEX 19B 

'% When SYCOUNTER (q.v.) reaches this value (i.e. time) wake up 

% the SMCP. The micro scheuler in gismo, after handling 

% interrupts, running a reader sorter use routine if required, 

% ensures that the SMCP will be selected when SY_CNTR_MSK is less 

% than SYCOUNTER. 
SY PRIOR TIME BIT (020)% HEX lAF 

% Previous N-second setting of SYCOUNTER. 
RESERVED FOR INTERP USE BIT (020)% HEX 1C3 

% ~ ~ ~ 
SYSTEM^PACK_INFO BIT(02l»)% HEX ID? 

% Points to a linked list of pack info tables. One table for 

% every ready pack on the system. 
RED ALERT RED._ALERT BOOLEAN% HEX lEF 

%TRUE ■=> non standard software has been supplied by the plant to 

% a specific site. 

% 

% 
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FILLER BIT(6)% HEX IFO 

SYSTEM_UNIT BIT(012)% HEX 1F6 

% Absolute disk address of the primary system disk. 

! [ SYSTEM PORT CHAN BIT (007) « HEX 1F6 
% - - 

! SYSTEM PORT BIT (003)% HEX 1F6 
% ~ 

SYSTEM CHANNEL BIT(004)% HEX 1F9 
% ~ 
3 

DUMMY_BIT RESERVED BIT (001)% HEX IFD 

% The serial number flag in a disk address must always be reset 

SYSTEM UNIT EU BIT(00lt)% HEX IFE 

% ~ " 

CONSOUL SWITCHES BIT (028)% HEX 202 

! SE_ENlBLE_VALUE BIT (4) % HEX 202 

MICRO TRACE FLAG BIT(001)% HEX 21E 

GISMO~TRACE"SPACE BIT (024)% HEX 21 F 

% AcTdress of the gismo trace header. The header consists of 

% TRACE SIZE BIT (24) 

% TRACE~0FFSET BIT (24) 

% The 24 Fits below the header is the trace mask. 

PORT CHANNEL TABLE BIT (192)% HEX 237 

! PCT ENTRY T8) BIT (024)% HEX 237 

% TFis array is subsripted by PORT number to yield the address 
% of the channel table for that port. Processor ports do not 
% have channel tables. The soft I/O subsystem, which interfaces 
% to the master processor via the CMND and DATA registers, is 
% deemed to be on port 7« 

BYPASS CLEANUP BIT (001)% HEX 2F7 

%TRUr => system panda can be removed from the name table. 

% 

% 
CONTRL CRD_FLG BIT (001)% HEX 2F8 

%TRUr => MCP is in control card driver.. 
EXT_RESULT_DESC CHAIN BIT (024)% HEX 2F9 

% Points to tKe first extended result descriptor in the chain. 

% See also EXT_RESULT_SAVED. 
T_FILES BIT (008)% HEX 311 

% Count of number of temporary disk files (i.e. in the directory 

% but DFH_PERMANENT = 1) encountered when cleaning up a disk. 
MICR COUNT BIT (006)% HEX 319 

% Count of the number of reader sorter files open. When the 

% first file is openned, hi-priority interrupt handling code is 

% made present In memory and marked save. 

% This code is segments and 6 of the MMCP, and all the user 

% interpreter external segments. 
CHANGE BIT BIT(001)% HEX 31F 

%TRUr ■> check the active schedule upon return to the ouuter 

% 1 oop . 
RELEASE VERSION B!T(008)% HEX 320 

SO IN_P1?0GRESS BIT(001)% HEX 328 

S A~squash of the system disk is in process, and most other 

% activity on the system shouuld be stopped. Only zip input, and 

% AC, AX, DM, DP, DS or LP messages are allowed for the program 

% squashing the system disk (see SO JOB NUMBER). 
I OAT POINTER BIT (0247% HEX 329 

% Starting memory address of the input output assignment table. 
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I OAT END BIT (024)% HEX ik} 

% Triding address + 1 of the I OAT. 
SYSTEM PAUSE_DESC BIT(02lt)% HEX 359 

% ReTerence address of the pause descriptor in the disk chain. 

% The pause descriptor is in SYS PAUSE DESC. 
PSEUDO TABLE_ADDRESS BIT(iy2A)% "HEX 371 

% AdHress of pseudo readers in memory. 
EMERGENCY_ODT Q^REGENERATI ON BIT(001)« HEX 389 

%TRUE «> reEtlTld the ODT queue at clear start. This must be set 

% manually. 

SQUASH_START I NG BIT (001)% HEX 38A 

% A squash of the system disk has been requested. This is set in 

% the procedure SQ. 
GISMO_OPTIONS BIT(02it)% HEX 38B 

% Certain portions of gismo code are discarded depending on the 

% system configuration and MCP options. This field records what 

% was kept. 

BIT(001)% 

bit(ooi)% 
bit(ooi 

BITCOOl 



FILLER 

comm trace 
gismU trace 
filler 

PORT devices 
B172(5 CODE 
Bl82O~C0DE 
MPROC'CODE 
BI83O CODE 

PRIORTTY MEMORY MGMT 
THRASHING COUNTTNG 
lamp CPU lASE 

fixeU laHp display 

VAR LTfMP BTfSE 

F I LlER ~ 

VAR LAMP 10 

F I LlER 

DCPU CODE PRESENT 

FILLlR 



DCH SCRATCH MEM ADDR 

% Points to DZH SCRATCH 



BIT(001, 

BIT(001, 

BITCOOV 

BIT(001 

BIT(00i; 

BIT(00i; 



BIT 
BIT 
BIT 
BIT 



001 
001 
001] 
001; 
BIT (001 
BIT(001 
BIT(001] 
BIT (001)% 
BIT (006)% 



HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 
HEX 



38B 
38c 
38D 
38E 
38F 
390 
391 
392 
393 
395 
395 
396 
397 
396 
399 
39A 
39B 
39c 
39E 



BIT (024)% 
MEMORY, which 



HEX 3A3 
contains vari 



ous variables 



% for NDL, such as the addresses of the network controller's 

% remote FIB, station FIB. For the complet 

% DCH SCRATCH RECORD. 
TASK IN~SCHED ~ BIT(001)% HEX 

INTERRUPT SWITCH SET BIT(001)% HEX 

DISABLE INTERRUPT SW BIT (001)% HEX 

FIRE 0DT_R0UTINES~ BIT (001)% HEX 

%TRUE "> the next pass through N-second must 
JOBS RUNNING BIT(012)% HEX 

, % IJount of jobs actually running. Used in N 

% the N-second interval. Value is 5 seconds 

% upper limit of 1 minute. 

% The number of jobs controlled by the mix limit (ML) 

% LIMITED JOBS, a variable on the SMCPs data stack. 
BEEN THRU MUP BE HERE BIT (001)% HEX 3CB 



3BB % FOR WFL TASKS 

3BC 

3BD 

3BE 

fire up system/odt. 
3BF 

second to calculate 
per job, with an 



IS in 



%TRUE -> 
% 
% 
% 
% 
REMOTE REROUTE 

%TRUr ■> gismo communicate 
% and wr i tes to the 



have already tried to bring in an MCP code dictionary 
and dictionary. We are not suceeding, therefore, rather 
than on a memory request that cannot be satisfied, and 
one which cannot wait, we reluctantly halt the system. 

BIT(001)% HEX 3CC 
router should send remote file reads 
SMCP rather than the MMCP. 
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QUEUE REROUTE BIT (001)% HEX 3CD 

%TRLlE => gismo communicate router should send queue file reads 
% and writes to the SMCP rather than the MMCP. 
% Whenever the SMCP uses queues (e.g. autobackup, job spawning 
% replies), the SMCP code is always invoked. 

DISK MONITOR GISMO BIT (004)% HEX 3CE 

SAVE~DUMP ~ BIT (001)% HEX 3D2 

% Fave the system memory dump (SYSTEM/DUMPF I LE) , even if the size 

% of SYSTEM/DUMPF I LE Is Incorrect. The size of the system dumpflle 

% depends on: 

% - memory size of the system 

% - the size of the MCP layout tables (these allow symbolic 

% analysis of the dump) 

% - the size of the ODT queue 

FILLER BIT(036)% HEX 3D3 

% Was INTERPRETER_TABLE_ADDRESS prior to 12.0. 
% This is still used by SYSTEM/IDA, to allow 11.0 dumps to be 
% analysed (to a certain extent) . 

ODT_P0RT_CHAN RECORD* HEX 3F7 

% For a system using an ODT I/O control, this field contains that 
% port and channel. For a system not using an ODT I/O control, 
% this field Is zero. The ODT control can be masked out (see 
% CHANNELS NOT PRESENT) on a non gem If required. 
ODT PORT ■" ~ BIT (003)% HEX 3F7 

ODT~CHANNEL BIT(002t)% HEX 3FA 

END 

KEYBOARD_ODT_DESC BIT(02it)% HEX 3FE 

% Reference address of the I/O descriptor used to communicate 
% with an ODT I/O control. 

LOCN BIOAW_RECOVER BlT(02if)% HEX itl6 

% Rot used. 

CHANNELS NOT_PRESENT BIT(0l6)% HEX it2E 

% At clear start, channels can be ignored by use of the FA 
% register (on non gem) or the TEXT IC message (on gem systems). 
% This can be useful when a control has a problem and prevents 
% either a succesful clear start, or trouble free running. 

LAMP DATA PTR BIT(0it8)% HEX lt3E 

, [ SEGMENT HALT BIT (004)% HEX hU 

! SPECiriC_HALT BOOLEAN* HEX if6E 

% See HALT MASK. 

DUMP_AT_HArT BOOLEAN* HEX ASF 

% If either a SPECI F I C_HALT or STOP_AT_ALL_HALTS, take a full 
% system memory dump, clear this flag and then halt. 
% (DUMP AT HALT is reset to avoid cloberrlng a previous dump.) 
% See tHe 5H S @hhhhhh@ D message. 
TRACE_HALTS BOOLEAN* HEX 470 

* Conditional halts are to be entered into the gismo trace 
% table. 

STOP AT_ALL_HALTS BOOLEAN* HEX 471 

%TRUr => stop at all conditional halts. 

HALT MASK BIT (024)* HEX 472 

% leftmost six digits of the SMCP sequence number (in hex) at 
% which to halt when the SPECI F I C_HALT flag Is TRUE. See the SH 

* message. 

* NB. this must match a CONDITIONAL_HALT sequence number. 

* The value Is In hex so that in an emergency the values can be 
% easily entered from the console. 

, [ MMCP SEGMENT HALT BIT (004)* HEX 48A 

! SPlCIFlC M?^CP HALT BOOLEAN^ HEX 48A 
% See MMUP HAUT MASK. 

FILLER ~ ~ BOOLEAN* HEX 48B 
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TRACE MMCP HALTS BOOLEAN% HEX kBC 

% MMCF conHitional halts are to be entered into the gismo trace 

% table. 

STOP AT_ALL MMCP_HALTS BOOLEAN* HEX kBD 

%TRUr => stop at all MMCP conditional halts. 

MMCP HALT_MASK BIT (024)% HEX kSl 

% leftmost six digits of the MMCP sequence number (in hex) at 

% which to halt when the SPEC! F I C_MMCP_HALT flag is TRUE. See the 

% SH M message. 

% NB. this must match a CONDITIONAL_HALT sequence number. 

% The value is in hex so that in an emergency the values can be 

% easily entered from the console. 
COMPILE_TIME_OPTIONS BIT (008) % HEX itA6 

% Records compile time options of the SMCP. 
I RELEASE_VERSION MCP BIT (001)% HEX 4A6 

% The RELEASr option was set. 

DEBUG OPTION BIT(001)% HEX 4A7 

% The RELEASE option was reset. 

FILLER BIT (006)% 6 MORE OPTIONS 

ENVIRONMENT OPTIONS BIT (004)% HEX 4AE 

% "" 

! USE_SLIO_ENV BIT (001)% HEX 4AE 

% Use the SDL2 logical I/O environment. 

USE_DATACOMM ENV BIT(001)% HEX 4AF 

% Use the SLTO datacomm and queue environment. 

USE_ISAM_ENV BIT (001)% HEX 4B0 

% Use the SLID ISAM environment. 

FILLER BIT(001)% HEX 4B1 

MCP_VERSION_DATE BIT(0l6)% HEX 4B2 

% Compilation date of M0D02. Since this module should be 

% recompiled for every patch to the MCP, this should yield the 

% MCP compile date. 

% Format YY bit 7, MM bit 4, DD bit 5. 

DMS_MM_EVENT BIT (001) I HEX 4C2 

% When the DMCP cannot proceed because memory management is 
% active this event bit is FALSE, and the DMCP is hung on it. 

DMS_MM_C0UNT B1T(006)% HEX 4C3 

% When memory management is about to overlay a DMS buffer, this 

% field is bumped. If the new value is one, DMS_MM_EVENT is reset 

% so that the DMCP will not try to use buffers." ~ 

% DELETE_DMS_.BUFFER (in ALLOCATE_S_MEMORY) then performs 

% additional checks. 

% When memory management has finished, this field is decremented, 

% and if the new value is zero, DMS_MM_EVENT is caused, to awaken 

% any DMCP which may be waiting. 

CURR INTERP_DIC_ENTRIES BIT (005)% HEX 4C9 

% ^ize of the interpreter dictionary. Default size is seven (7). 
% The MMCP, GISMO and the SDL2 interpreter occupy entries 0, 1 and 
% 2 respectively. Thus four user interpreter slots are available. 
% The size can be changed with the IC ODT message. A Clear/Start 
% is required to change the size. 

DM GLOBALS BIT (024)% HEX 4CE 

f Pointer to a linked list of DMS GLOBALS. 

QUEUE_ROOT BIT (074) % HEX 4E6 

% Points to the queue subsystem globals. 

TOP S COMM QUEUE BIT (024)% HEX 4FE 

%~ ~ 
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DC CHAIN BIT(02i»)% HEX 51 6 

? Points to a linked list of DC POCKET_RECORDs, which remember 

% which job is using which adapter. Unusually, a null list is 

% indicated by 0. 
TRUTH TABLE_ADDR BIT(02i»)% HEX 52E 

% Contains the address of the truth table. This table contains a 

% bit for each patch number. Therefore, all the bits upto the SMCP 

% patch level should be on, and all those after should be off. 

% This is built and checked during clear start. If the table fails 

% the check, then we halt with L-@000011@, T-@333333§- The halt 

% itself is push through, but that decision should not be taken 

% lightly - patches are missing, and patches are quite often 

% interdependent. Contains zero when not set up. 
FILLER BIT(012 % HEX 5^6 

S_C Q_EV BIT (001)% HEX 552 

%~Smcp Communicate Queue EVent. 

%TRUE "=> There is at least one program waiting for the SMCP to 

% handle the progam's communicate. 
M_C Q_EV BIT (001)% HEX 553 

%~Mmcp Communicate Queue EVent, 

% On 10.0 and earlier releases, TRUE »> there is at least one 

% program waiting for the MMCP to handle the program's 

% communicate. 

% On 11.0 and later, gismo uses a different mechanism to awaken 

% the MMCP, and this field is not used. 

% If a program is running, and executes a communicate for the 

% MMCP, then the gismo communicate router will run the MMCP for 

% that program. 

% If a program is waiting in the MMCP communicate queue or the 

% I/O complete queue, the MMCP will be executed based on the 

% program's priority compared to other programs. 
S_M_Q_EV BIT (001)% HEX SS't 

% Smcp Message Queue Event. 

%TRUE => there is a message for the SMCP in the interrupt 

% queue. These messages are usually I/O complete 

% messages (loosely interrupts). 
S_I_Q_EV BIT (001)% HEX 555 

% Smcp Interrupt Queue Event. 

%TRUE => there is a high priority message in the interrupt 

% interrupt queue. 

% This has not been used since 6.1 when high priority handling 

% (for reader sorters) was moved to the MMCP. 

% Kept here in case we ever want to put some high priority 

% processing in the SMCP. 
M M Q_EV BIT(001)% HEX 556 

~%~Mmcp Message Queue Event. 

%TRUE => there is a message for the MMCP In the interrupt 

% These messages are always I/O complete messages 

% (loosely interrupts). 
M_l Q_EV BIT (001)% HEX 557 

%~Mmcp high priority Interrupt Queue Event. 

%TRUE »> there is a high priority interrupt for the MMCP. 

% Currently only used for reader sorters. 
M CAUSE LOCK BIT (001)% HEX 558 

~% ~ 
M EV FILLER BIT (005)% HEX 559 

~% ~ 
M_MCP_LR BIT (024)% HEX 55E 

% A psuedo limit register (processor LR) for the master MMCP. See 

% MASTER MMCP DATA PTR. 
LOCK ADDRESS " ~ BIT (024)% HEX 576 

% ~ 

% by gismo. 
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MCP_RSN_ADDR BIT (024)% HEX 58E 

%~Memory adddress of the SMCP's run structure nucleus (RSN) . 
DISK TABLE BIT (024)% HEX 5A6 

% Contains the drive transformation vector which is loaded to the 
DSC to allow drive numbers to reassigned at no cost to the MCP 
or gismo. The vector is actually loaded by system init. The 
purpose here is to inform the user that drive transformation 
has occurred. 



% 
% 
% 
% 
DRIVE NBR (8) 



BIT (003) 



. [ 



HEX 
HEX 



61A 
636 



HEX 63E 



. [ 



TASK MIX NO BIT(014)% HEX 5CE 

JOB HlX RO BIT(014)% HEX 5DC 

WFCQUEDE_ADDRESS bit (024)% HEX 5EA 

% Address of the WFLQUEUE, which is the queue of WFL commands 

% between the MCP and SYSTEM/WFL. Also used by the RIB mechanism. 

NC QUEUE_ADDRESS bit (024)% HEX 602 

^ Not used yet. 

FILLER BIT (044)% 

M MCP QIDENT BIT(008 % 

~% ~ 

COMM SPLITTER ADDR BIT (024)% 

% Hemory ad3ress of the array used by the communicate router in 

% gismo to route communicates to the appropriate part of the MCP 

% T4=>SMCP, 5'*>MMCP, 2=>DMCP) or a special system environment 

% (3=>IBASIC). Each entry is 3 bits wide. 
COMM SPLITTER LENGTH BIT(0l6)% HEX 656 

% length of "the comm_spl i tter array. See above. 
FIRST_RUN UNIT BTT(024)% HEX 666 

% Cobol74 style IPC uses the verb call. Passing parameters 

% between different tasks is permitted. Each such group of tasks 

% is called a run unit. This points to the first in the linked 

% 1 i St of run uni ts. 
INDEX SEQ USER COUNT BIT(008)% HEX 67E 

% Count of tHe number of ISAM (Cobol 74 or RPG $IXSEQ) files 

% open. 
MIKES_HALT_SPACE BIT (096)% HEX 686 

% When the system comes to a controlled halt, the values of the 

% L, T, X and Y registers are stored here. 
! FILLER BIT (048) 

SMCP HALT NOMEM SEQ_N0 BIT (032 % HEX 6B6 

FILLlR ~ " BIT (016) 

RIB_LIST BIT (024)% HEX 6E6 

%~Pointer to the linked list of routing information blocks 
% (RIBs) . 
LAST LINK BIT(024)% HEX 6FE 

% Hemory address of the last memory link. 
SMCP CPU_PRI0RITY BIT (024)% HEX 716 

% The current SMCP processor priority. The micro scheduler 
% gismo uses this field rather than the field in the SMCP's 
% because since the RSN is above the MCP LIMIT register, the SMCP 
% cannot write to the RSN field. ~ 
LAMP GLOBALS BIT(014)% HEX 72E 

I LAHP scale bit (003)% HEX 72E 

[ VL AILS bit (003)% HEX 731 

I VL AUCPU BIT(001)% HEX 731 

BIT(001)% HEX 



in 
rsn. 



VL AUCOLAY 



732 
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% 



1 



VL_AUDOLAY 

FILLERC 
VL SSWC 

laHp_options 

I 



C 



FLTfMPS 
VLAMPS 
! VLAMPS 
VLAMPS" 



CPU 

■|0 " 



OLAY 



VLAMPS BAR GRAPH 



] 



VL SMCP OLAYF 
! VL SMCP OLAY 
VL~SMCP OLAY 



USE 



BIT(001)% HEX 733 

BIT(001)% HEX 73^ 
BIT(q01)% HEX 735 
BIT(00lt)% HEX 736 
BIT(001)% HEX 736 
BIT(002)% HEX 737 
BIT(001)% HEX 737 
BIT(001)% HEX 730 

BIT(001)% HEX 739 

BIT (002)% HEX 73A 
BIT(001)% HEX 73A 
BIT(001)% HEX 73B 



JOBS SWEEPS 
SYSTlM ID ■ 
! CPU TD 

o=er:ror 



MEMORY ID 
0=DE FAULT 
10 ID 

o='Pefault 



BEFORE DECAY 



1=B1710 
3=Bl830 
5=B1900 



73C 



1-CORRECTABLE 



BIT(010)% HEX 
BIT(012)% HEX 

BIT(00li)% HEX' Jki 
=81720 
»Bl860 
=81900 (GEM) 

BIT (004)% HEX 74A 

s-memory parity 

BIT (004)% HEX 74£ 



ELOG HERE 
QLOCK COUNT 

CHIP Table address 
MIX Hemory priorities 



BIT(02it)% HEX 752 
BIT (004)% HEX 76a 
BIT(024)% HEX 76E 
BIT(016)% HEX 786 
% Treated as MEM0RY_PRI0RITY (16) BOOLEAN. If there is a job in 
% the mix, with memory priority n, then MEMORY PRIORITY (n) will be 
%TRUE. 
STOP SCHED_INPUT BIT(001)% HEX 796 

% Ho not bring any more tasks out of the active schedule. 
% Set when; 

% - the system is thrashing (i.e. full) 
% - a squash of the system disk is scheduled 
% - the number of running jobs would exceeed MAX TASKS. 
NSEC DISABL THRASH FAULT BIT (001)% HEX 79i 
DISABLE THRASHING FAULT BIT (001)% HEX 79t 
MCP_VARTABLE_MEM_PRI0RITY bit (004)% HEX 799 

% The current memory priority to be used for SMCP memory 
% requests. When performing work on behalf of a program, the SMCP 
% will set this field to that program's memory priority. 
DOING FILE ATTRIBUTE COMM BIT(l) % HEX 79D 
[ GOTTA DR OR_TR " BIT (2) % HEX 79E 
% CReclced at N-second to remind the operator. 
! GOTTA DR BIT(l) % HEX 79E 

% Waiting for an operator DR before releasing the schedule. 
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GOTTA TR 
% Wa i t i ng 



BIT(l) % HEX 79F 
for an operator TR before releasing 



the schedule. 



The actual 
of other work. 



MEM_SWEEP_PENDING BIT (001)% HEX 7A0 

%~A gismo memory sweep of memory links is required. 
% sweep can be delayed a few clock due to pressure 
SAMPLING CLOCK BIT(006)% HEX 7A1 

SAMPLING" INTERVAL BIT 006)% HEX 7A7 

MEM SWEEP INTERVAL BIT (010)% HEX 7A0 

MAX~SWEEP~ INTERVAL BIT (010)% HEX 7B7 

MEM~EXTENU count bit (002)% HEX 7C1 

OVERLAY COUNTER BIT(008 % HEX 7C3 

OVERLAY"TARGET BIT(008 % HEX 7CB 

MCP SWElPS BEFORE DECAY BIT (010)% HEX 7D3 
MEM DUMP_CUMPLETE BIT (001)% HEX 7DD 

? Set by system/init to record the fact that a system memory 
% dump was taken during clear start. During SMCP initialization, 
% this conditions the memory dump completed message. 
MAX MEM_PRIORITY IN_MIX BIT (004)% HEX 7DE 

^ Highest actTve memory priority. The SMCP uses this priority 
% when performing general housekeeping. The point is to avoid 
% introducing another active memory priority. 

"IT(001)% HEX 7E2 

(CTRL_CARD_DRIVER) to ensure that 
WFL job log exactly once. Set when 



Bl 
driver 
in the 
logged. 

B1T(001)% 



COMMAND LOGGED 

% UsecT by control card 

% commands are entered 

% the command has been 
CONTROLLER_SCHEDULED B1T(001)% HEX 7E3 

% Since the NOL newtork controller has been scheduled, please do 

% not fire up another copy if remote file open is received before 

% the network controller has initialized. 
DCPU ID BIT(002)% HEX 7EA 

% ^et by systesm/init to record which processor 

% processor environment is master, and which is 



in a dual 



MASTER 

SLAVE 
TASK TABLE ADDR 
CLEAR START REQD 
SCHEDULER_BrOCK COUNT 

% When <> 0, the micro 

% sorter use routines, 

% desi re 
FIRE MCS 
DCPU DATA 
MASTlR PORT 
SLAVE PRESENT 
SLAVE_PORT 
FIRE NDL 
WFL JOB NO 
[CACHE I ITS 

! NO Ram disk_ 

NO RAM DISK 2 
NO CACHE 1 
N0~CACHE~2 
CAUHE prise NT 1 
CACHE~PRESENT 2 



BIT(001)% 
BIT(001 % 
BIT(02it)% 
BIT(001)% 
BIT (008) % 
scheduler in 
or the SMCP. 



(A or B) 
s 1 ave . 

HEX lEk 

HEX 7E5 

HEX 7E6 

HEX 7FE 

HEX 7FF 
gismo will only run reader 
Bumped by SMCP procedures that 



to heive complete control of the system for awhile. 

BIT(001)% HEX 807 

BIT(02M% HEX 808 

BIT (003)% HEX 820 

BIT(001)% HEX 823 

BIT (003)% HEX 824 

BIT(001)% HEX 827 

BIT(016)% HEX 828 

BIT (6)% HEX 838 



1 



BIT(1 
BIT(1 
BIT(1 
BIT(1 
BIT(1 
BIT(1 



1% 
1% 
• % 
1% 

1% 

] 



HEX 
HEX 
HEX 
HEX 
HEX 



839 
83A 
83B 
83c 
83D 
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FILLER 

BNA ADDRESS 

REAt MEMORY_SIZE 
% Highest memory 
% Note that both 
% same settings. 

PSEUDO_MEMORY_SIZE 
% Highest memory 
% than 
% NB: 



83E 



BIT (002) « HEX 

BIT (024)* HEX 81 

BIT(02it)% HEX 858 

address (in bits) on the system 

processors, and the memory base 



(i .e, 
must 



MAXS-1) . 
have the 



BIT(02M% 
address (in bits) on 
REAL_MEMORY_SIZE if the LR register 
It is no good trying to use this to 



HEX 870 
the system. Will be less 

was set at clear start. 
find a L-@0D0055@ 



« problem since the memory is still present. ALL the relevant 

% MAXS Jumpers must be changed. 

% L=@OD0055§ cannot occur on a 2MByte system. Therefore for 

% "strange" problems try reducing memory ON THE MAXS JUMPERS. 
TIME MARK BIT (024)% HEX 888 

MASTlR MMCP DATA PTR BIT (024)% HEX 8A0 



should 
in system 
HEX 8b8 

HEX 8D0 
messages to 

HEX 8e8 



match MMCP_ 
halts. 



SYSTEM/ODT. The 



uses to access 
should not be 
f i 1 es . 



G i smo , to 
once, and 

are val id. 



no 



% Address of tTie master MMCP's data. This should match MMCP LR. 

% Also used as a pseudo limit register 
SLAVE MMCP_DATA_PTR BIT (024)% 

% AHdress of the slave MMCP's data. 
ODT F I LE_ADDR BIT (024)% 

% AHdress of the queue descriptor for 

% queue is called "FROM-MCP". 
SYS_0DT_J0B NO BIT (01 6)% 

% Job numEer of SYSTEM/ODT. 
SYS ODT DIO DISK DESC ADDR ADDRESS* HEX 8F8 

%"Address~of tHe l/U descriptor that SYSTEM/ODT 

% the disk area known as SYSTEM/ODT-QUEUE. This 

% confused with a queue structure used for queue 
SYS_PAUSE_DESC BIT (272) 

% The head of the disk chain. Used as a marker by 

% ensure that the full chain is searched at least 

% more than twice. 
EXT RESULT EXISTS BOOLEAN 

%TRUE => EXT RESULT SAVED and EXT RESULT HIT DESC 
EXT_RESULT_SAVrD ~ BIT(9E) " ~ 

%~Saved extended result descriptor. 
EXT_RESULT HIT_DESC BIT (175) 

% Saved Teft hand part of the I/O descriptor 
DFH_DIR_LTH WORD 

% Length of the disk file header dictionary. 
MPF_DIR_LTH WORD 

% Length of the Multi-Pack File dictionary. 
MPF_DIR_AD ADDRESS 

% Address of the start of the Multi-Pack File dictionary. 
LOCN DESC_BIOAW_RECOVER ADDRESS 

% Address of the system descriptor containing the 

% BIOAW RECOVERY. Built during initialisation and 
TRACE__HALT DA ADDRESS 

TRACE HALT BUF PTR ADDRESS 

S(J_JOl_NUMlER ~ BIT (16) 

% Job number of the system/squash program which is squashing the 

% system disk. 
SO MSG_ADDR ADDRESS 

* Not used. 
MASTER_IDLE TIME 

% Total iHle time for 
SLAVE_IDLE^TIME 

% Total Tdle time for 
SMCP START^TIME 

% WaintaTned by gismo. 
SMCP SERV I CENTIME 

% Haintained by gismo. 



in error, 



See also DFH DIR AD. 



code for 
never changes. 



PROCESSOR_TIME 

the master processor 

PROCESSOR_TIME 

the slave processor. 

PROCESSOR_TIME 

The SMCPs processor 

PROCESSOR TIME 

The total SMCP~service 



time at the start. 



time. 
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MEM_STATISTICS_ADDR ADDRESS 

%~Address of "the table used to maintain memory usage statistics. 
PROTECTED_FILE_COUNT WORD 

% When the system disk is being cleaned up (in DISK_CLEAN_UP) , 

% a count is l<ept of PROTECT! ON-PROTECTED files encountered. 

% Should this field be non zero, then the program in the PAN 

% slot in the name table (usually SYSTEM/PANDA), will be initiated 

% to handle correcting the end of file pointers for those files. 

% 
EXPIRED PROC TIMES BIT(lif4) 

% When a job is teminating (i.e. dying or expiring), it's various 

% processor times are added to these totals. 
! EXP PRIMARY INTERP TIME 

EXP~PRIMARY~SMCP TTME 

EXP'PRIMARY MMCP~TIME 

EXP"DMS INTlRP TlME 

EXP~DMS~SMCP TIME 

EXP~IBAllC IRTERP time 



] 



BIT! 


2k) 


BIT 


2k] 


BIT 


2k] 


BIT 


2k\ 


BIT 


2k\ 


BIT 


2k) 



DECLARE HINTS H I NTS_RECORD; 
% This must remain the first declare, so that the space appears 
% first in the data stacic, and thus at absolute address 0. 
RECORD INTERP_DICT ENTRY 

% One entry for each firmware file used by the running 

% system. Entry is MMCP, 1 is GISMO, and 2 is the SMCP's 

% interpreter (SDL2/INTERP for 11.0, SDL2/INTERP1M for 12.0). 
SEG Die SYSTEM_DESCR, 

%~The system descriptor for the interpreter's segment 

% dictionary (if any), else for the non-segmented code. 

% This descriptor is call led the ED or external descriptor. 
FILLER BIT(8), 

% Prior to 12.0 was:- 

% ENTRY IN USE BOOLEAN. 

% RSDNT'USIRCOUNT BIT (7), 

DATA_SPACE_.STZE B I T (2i») , 

% Size of the interpreter's worl< space (if any), to be 

% attached to the environment. 
PRE_INIT DATA SIZE BIT(l6) , 

% Size~of tKe worit space to be initialised from the 

% interpreter code file (only valid when DATA SPACE_SIZE > 0). 
INIT DATA_OFFSET BIT(l6) , 

% Uffset of the pre-ini tial ised work space in the interpreter 

% code file (only valid when PRE INIT DATA SIZE > 0). 
GLOBAL_SEG SYSTEM HESCRT 

% System descriptor for the interpreter's global (or main) 

% segment. The version is in hex {k bytes) before the check 

% sum at the end of the segment. 

% This descriptor is called the GD or global descriptor. 
ENTRY IN USE BOOLEAN, 

% l7 TRUE, this entry is in use and all fields are valid. 

% If FALSE, this entry is free (and all fields refer to the 

% most recent occupant) or the entry is being built (and 

% field values relect our progress). 

% Note that this bit is set as the last order of busness. 
RESIDENT_USER COUNT BIT(15), 

% Number of environments using this interpreter that are not 

t rol led out. 
TOTAL USER COUNT BIT(l5), 

% Total riumber of environments using this interpreter. 
FILLER BOOLEAN, 

% To allow the following fields to stay byte aligned for 

% ease of debugging. 
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ARCHITECTURE_NAME NAME, 

% The name of the architecture for this interpreter, 

% e.g. SDL2, COBOL?^, RPG. 
COMPILER_LEVEL BIT (8), 

% An integer representing the level of the S-machine for this 

% architecture. Checked against a corresponding program PPB 

% field. 
ARCH[TECTIJRE_ATTRIBUTES BIT(80) , 

% Used for checl<ing minor S-machine changes (such as adding 

% an S-op) that are not significant enough to warrant a level 

INTERPRETER_NAME NAME RECORD, 

% The name of the interpreter on dTsl<. 

[DFH ADDR DISK_ADDR! 

% The disic address of the interpreter's DFH. 
AREA ADDRESS_FOR MMCP GISM0_SDL2 DISK ADDR], 
% For MMCP, GI^MO, S^DL2 i nterpreter~i t is too difficult to 
% build the DFH address. So we settle for the area address. 

VERSION BIT (32), 

% Contains the interpreter version. For use by ISSA. 

FILLER BIT(36); 

% Available for future use. This filler is used to extend 
% the size of an entry to 768 bits, so that Gismo can 
% compute the offset of individual entries by two shifts and 
% an add (i.e. to require the same amount of work as 22U bits 
% required prior to 12.0.) (which is required every time a 
% task is reinstated). 
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RUN STRUCTURE NUCLEUS 

As shown in figure D-1, the run structure nucleus includes variables that point to the next task in the 
mix, the file dictionary for the task, and the environment dictionary for the task. 

A programmatic description follows. 



% 

SET rs_status_types MEMBER ( 

executi ng 

no_f i 1 e 

no_user_di sk 

dupl icate_l ibrary 

dupl icate~input_f i le 

possible 3up 

waiting 7or_hardware 

program~stopped 

wai ting~IO_complete 

wtg_datacomni msg 

wai ting_overTay 

wai ting~kbd_in 

hdwr_^not_ready 

wai t7ng_operator_action 

waiting close ~ 

waitinglDS or_DP 

no_mpf_pacT< 

no f i le_on__disk 

waTt i ng~f o?_l ocked_f i 1 e 

wai ting~q_is_fu1 1 

wai t_status 

nomem_wa i t i ng_comm_q 

nomem_wa i t i ng~ready_q 

wtg_port_open 

wtg_pgm_cal 1 

wa i t i ng_t i me_comm_q 

wa i 1 1 ng~t i me~r eady_q 

wai ting~receTve 

wtg_datacoinin_opn 

terminating 

i n_ready_q 

i n~comm_q 

stopped for_sort 

wtg_dc_cfsk_cmp 1 1 

wtg~datacomm_dsk 

no_control ler 

no output_pack 

vsort_qsort_not^present 

no so?t_input_fTle 

waTt i ng_content i on 

wai ting_syncpo lint 

wa i t i ng_recovery 

wa 1 1 i ng_new_aud i t 

wa i t i ng~sor ter_^l 
termi nat i ng_waTt i ng_l 

c 1 0S i ng_wa i t i ng_ 1 

wai ting_forms ~ 
no_trans 1 ate_f i 1 e 

mf~searching~ 
no_DMS_f i 1 e 
no_DMS~d i c t i ona r y 

wtg_DM5_reorgan i zat i on 

wtg~inactive_data_base 



15) = 
= 
= 1 
= 2 



= 10, 
= 1 
= 12, 

- 14, 

- 19. 

- 20, 
= 21, 

- 22, 

'•II: 
:li 

" 29, 

= 30, 

- 31. 
= 32, 

-.11: 
'■11: 
:ll: 

= 39. 
= io, 
= 41, 
■= 42, 
= 43, 
= 44, 

'11: 
■-U: 

- 49. 

- 50, 

- 51. 
= 52. 
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no usercode 
waTt i ng_to_be_ca 1 1 ed 
wtg_program_exi t 
wtg~ca1 led_pgm_BOJ 
wtg~rel_area__ini t 
wtg~datacotnm„resul t 
wtg~beg i nn i ng_l abe 1 
no_program ~ 
no~host_services 
wtg_host 

wa i t i ng_task_comp 1 et i on 
wai ting~system_lock 
no_d i s k_WF L_ 1 og 
no DMS_accessroutines 
waTti ng_server_message 
wai ting~protected file 
,wai ting~schedule_3isk 



,wai ting_sort_disk 



5?' 
5^. 
55, 
5t 

ii 

to, 
61, 
62, 

II: 
II- 
"I 

% 

72% 

% 



Used when program call could not 
schedule the callee, because of 
lack of disk space. 

Used when sort initiation failed 
because no Q_DISK was available. 



CONSTANT MAX REASON 



= TYPE_LENGTH (rs_status_types) - 1; 
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RECORD 

RS NUCLEUS 

~ RS CUR ENV ADDR BIT (24) , 

~ ?ABSULUTE address of the CURRENT ENVIRONMENT NUCLEUS 

% INCLUDED FOR EASIER AND FASTER ACCESS B,Y MMCP AND G I SMO 
RS CUR ENV INDEX BIT(l6) , 

~ fNUMlER OF THE ENTRY IN THE ENVIRONMENT DICTIONARY FOR 
%THE CURRENTLY ACTIVE ENVIRONMENT 
RS ENV DICT SIZE BIT(l6) , 

~ ^NUMBlR OF ENTRIES IN THE ENVIRONMENT DICTIONARY FOR THIS 
%JOB. CURRENTLY WE ALWAYS ALLOCATE 'MAX ENVIRONMENTS' 
%ENTRIES AS FOLLOWS (EXCEPT FOR THE SMCP, WHICH HAS 1): 
% - THE PRIMARY ENVIRONMENT (THE EXECUTED PROGRAM) 
% 1 - AN ASYNCHRONOUS MCP ENVIRONMENT (NOT IN 
% INITIAL IMPLEMENTATION) 

% 2 - A DMS ENVIRONMENT 

% 3 - A SPECIAL ENVIRONMENT (USED BY I BAS I C) 
% 

%THE TABLE IS SIMPLY A LIST OF ABSOLUTE MEMORY ADDRESSES 
%IF AN ENVIRONMENT HAS NOT BEEN ALLOCATED, THE ADDRESS 
%FOR THAT ENTRY WILL BE ZERO. 
RS ENV Die POINTER ENVI RONMENT_DI CTIONARY, 

RS~FIB~DIC BIT(24), 

~ fMEMORY ADDRESS OF THE FIB DICTIONARY 
RS SELF ADDR BIT (24) , 

~ SHAKES IT EASIER TO SEARCH FOR AN RSN AT A SPECIFIC 
%ADDRESS, AND ALSO SERVES AS A CHECK THAT A STRUCTURE 
%IS ACTUALLY AN RSN 
RS MCP BIT BOOLEAN, 

~ ?IF TRUE, THIS IS THE SMCP'S RSN. NOTE THAT THIS BIT 
%DUPLICATES A BIT IN THE ESN. THE ESN BIT IS PRIMARILY 
%FOR THE CONVENIENCE OF THE INTERPRETER, AND THIS BIT 
%MAINLY FOR THE CONVENIENCE OF SMCP 
RS ODT INPUT PRESENT BOOLEAN, 

~ ^INDICTfTES THAT AN AX WAS DONE 
RS TRACE BUF ADDR BIT (24), 

~ iMlMORY ADDRESS OF THE TRACE BUFFER IF THIS 

%JOB IS TRACING - SHARED BETWEEN ALL ENVIRONMENTS 
RS TRACE BUF OFFSET BIT(l6), 

~ %CURRERT OFFSET WITHIN THE TRACE BUFFER 

^PREVENTS CONFLICT WHEN TRACE IS ACTIVELY SHARED - FUTURE 
RS SWITCHES BIT (40) , 

~ %10 4-BIT SWITCHES: SWO-9 
RS IPC DICT ADDR BIT (24) , 

~ ^ABSOlUTE ADDRESS OF THE IPC DICTIONARY FOLLOWING THIS 
%RS NUCLEUS. (FOR IPC) 
RS IPC DirT SIZE BIT(16), 

~ ^NUMBlR OF ENTRIES IN THE IPC DICTIONARY 
RS CALLERS RSN ADDR BIT(I4). 

~ %RSN~ADDRESS of THIS JOBS CALLER 
RS LAST LIO STATUS SIZE BIT(l6), 

~ %5IZE~0F last LIO STATUS MASK 
RS LAST LIO STATUS FTR " BIT (24). 
~ %^DDRlSS OF lAST LIO STATUS MASK 
RS SLAVE BLOCKED CNT " ~ RECORD 

~ %NtlMBER OF~BLOCKS ON THE SLAVE SCHEDULER FOR THIS JOB 
RS BLOCK CNT BIT (6) 

RS QLTNK " BIT (24) , 

~ %P0 INTER TO THE NEXT JOBS RS NUCLEUS 

%FIRST QUEUE POINTS TO 1ST JUB; LAST JOB CONTAINS §FFFFFF@ 
RS LAST TOP ~ BOOLEAN, 

~ %TF set, INDICATES THAT THIS JOB WAS THE LAST ONE 
%SCHEOULED WITHIN ITS PRIORITY CLASS 
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RS_Q_IDENT BIT (24). 

%THE QUEUE THAT THIS JOB IS CURRENTLY IN 

% = READY Q 

% 1 = S COMR Q 

% } " EXTERMINATE Q 

% 6 = IOC Q. Waiting for MCP to handle an I/O complete. 

% 10 - M CCMM Q 

% 11= WJfTE Q~ 

% -2 = NOT IJUEUED. 

% The program may have a processor (i.e. be truly 

I executing), Gismo soft I/O may be running {as a 

* result of an interrupt whilst we were), or the 

% SMCP may be fiddling with the RSN. 
RS_NEXT Q BIT(2it), 

%IF THIS JOB IS IN THE WATE Q, THE QUEUE IT SHOULD BE 

%PLACED IN WHEN IT IS CAUSEU 
RS_TERMINATING BOOLEAN, 

%THIS JOB IS TERMINATING - PREVIOUSLY WE HAD TO TEST 

RS REASON BIT(8) , 

% USED BY MULT I -THREADING PROCESSES TO INDICATE PROGRESS 
% SO FAR. SHOULD BE CLEARED AT THE END OF THE COMMUNICATE. 
% ALSO USED DURING TERMINATE (CONDITIONED BY RS TERMINATE) 
RS_STATUS MEMBER OF rs status types, 

%GIVES THE CURRENT STATUS OF THE JOB ~ 
% refer to the set declared immediately preceding. 
RS_PR I OR I TY I NTEGER B I T (4) , 

^PROCESSOR PRIORITY - 0-15 ALLOWED 
RS_JOB NUMBER IN DECIMAL BIT(l6), 

? E G, 70B~NUMBER 1753 WOULD BE §1753@ 
RS PAUSE ~ BIT(2lt), 

%TIME TO WAKE THIS JOB IF SLEEPING 
RS WAIT LEN BIT(12), 

~ %rENGTH OF RS EVENT SPACE 
RS_WAIT LOC ~ ~ BIT(2if), 

%7fDDRESS OF RS EVENT SPACE 
RS DISABLE- INTERRUPTS" " BIT(6), 

%IF THIS FIELD IS GREATER THAN THEN THIS JOB MAY NOT 
%BE INTERRUPTED BY HIGH PRIORITY INTERRUPTS. 
RS„USE FLAG BOOLEAN, 

fiF TRUE, JOB IS CURRENTLY ACTIVE IN A 
%USE ROUTINE 
RS_REPORT EV I NX BOOLEAN, 

%USrD lY PROCESSES THAT WISH TO HANG JOBS AND HAVE THE 
%EVENT WHICH WAKES UP THE JOB REPORTED IN THE RS 
%(USED BY M WAIT AND COMPLEX WAIT) 
RS_STATE LIGHT ~ RECORD 

RS VlAMP DATA RECORD 

?USED lY THE LAMP CODE IN GISMO TO DISPLAY ACTIVITIES 
%BY JOB. INITIALLY, INFORMATION WILL BE SUMMARIZED FOR 
%ALL OF THE JOBS ENVIRONMENTS 

RS_VL 2FLAGS RECORD 

RJ VARIABLE LAMP CPU RECORD 

~ %USED TU DISPLAY JOB CPU ACTIVITY 
RS VL CPU GRP BOOLEAN, 

RS VL CPU~USE BOOLEAN 

END, 
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RS VARIABLE LAMP CODE OVLY RECORD 

%USED tU display Job code overlays 

RS VL COLAY boolean. 

fiIleR boolean 

end, 

RS variable lamp data OVLY RECORD 

%used tu display Job data overlays 
rs vl dolay boolean, 
fiEleR boolean 

END 
END, 

FILLER BIT(IO) 

END 
END, 
RS_TIME EVENT BOOLEAN, 

RS_NULL EVENT BOOLEAN, 

RS_JOB_RUMBER BIT(l6), 

%CONTAINS THE JOB NUMBER ASSIGNED TO THIS JOB. ASSIGNED 

%WHEN THE JOB IS SCHEDULED. JOB NUMBER IS USED ON ANY 

%ODT INPUT MESSAGE THAT REQUIRES JOB IDENTIFICATION. 

%BEGINS WITH 1 AND WRAPS AROUND AT 9999 
RS_ABORT BIT (2), 

% B RUNNING 

% 1 - DS OR DP-ED 

% 2 » CANCELED 

% 3 - DUE TO DEATH IN FAMILY 
RS_DC_IO_COMPLETE BOOLEAN, 

|THIS EVENT IS CAUSED WHENEVER A DATA COMM I/O OR 

%AN INITIALIZER I/O COMES COMPLETE 
RS DATA COMM BOOLEAN, 

%IF TRUE, JOB HAS DONE A DC INITIATE 10 
RS_SORTER FLOWING BOOLEAN, 

~%MICR JOB WITH READER/SORTER CURRENTLY IN FLOW MODE 
RS ROLLOUT BITS RECORD 

~ RS_TO IE ROLLED OUT BOOLEAN, 

~%ir TRUE,~JOB IS A CANDIDATE FOR ROLLOUT - DO IT NEXT 

%N SECOND 
RS NOT A~ROLLOUT CANDIDATE BOOLEAN 

?lF TRUE, Job HAS BEEN HUNG BUT CANNOT BE ROLLED OUT 
END, 
RS_ROLLOUT IN_PROCESS BOOLEAN, 

fIF TRUE, JOB IS IN PROCESS OF BEING ROLLED OUT 
RS ROLL IN IN PROCESS BOOLEAN, 

%lF TRUE, JOB IS IN PROCESS OF BEING ROLLED IN 
RS_PREVENT MOVE BOOLEAN, 

?IF TRUE, THIS RSN MAY NOT BE MOVED 

%N0 CURRENT USES 
RS DISPLACED BIT{2it) , 

%THE DISTANCE THIS RSN HAS BEEN MOVED 
RS MEDIA BOOLEAN, 

%IF RESET, THEN SOME ENVIRONMENTS MAY BE ROLLED OUT 
RS INTERVENTION BOOLEAN, 

%SMCP NEEDS TO DO SOMETHING TO THIS JOB BEFORE 

%THE MMCP CAN HAVE IT (USUALLY ROLL IN) 
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RS M PROBLEM RECORD 

TREASON WHY THE MMCP OR GISMO TURNED CONTROL OF THIS 

%JOB OVER TO THE SMCP 
RS M PROBLEM TYPE RECORD % FOR SDL 

~ RS M PROl PI BIT (24) % FOR MIL 

f T«LIO~PROBLEM (SEE PARAMETERS) 

% 3-FIB DICT NOT PRESENT 

% 5-RS INTERVENTION SET 

% 7-DUHP COMMUNICATE SENT TO MMCP 

%10-RELATIVE FILE PROBLEMS 

%20-MMCP PAGE FAULT (PARAMETER=SEG DESC ADDR) 

%21-GISMO TERMINATE (SEE PARAMETER FOR TYPE 21) 

%22-ENViRONMENT NOT PRESENT 

%30=!NVALID COMPLEX_WAIT COMMUNICATE 

%31=N0 ODT QUEUE 

%no«Port, "queue, or remote file problem (see parameter 

% for type 110) . 

% 
END, 

RS M PROBLEM PARAMETER RECORD % FOR SDL 
~ T?S M PRO^ P2 BIT(2A) % FOR MIL 

:? A*ftW TYPE 1 **** Logical I/O problem. 

% 1=IRREC0VERABLE EXCEPTION 

% 2=F1B NOT OPEN 

% 3=WR0NG POSITION 

% lf=NEED NEW AREA 

% 5- INVALID CHARACTER ON PSEUDO READER FILE 

% 6-EOF 

% 7-AREA OUT OF BOUNDS 

% 8-DISK FILE HEADER INDICATES A MULTI PACK FILE 

* 9-AREA NOT PRESENT 

%10-LOGICAL I/O ALLOWED ONLY FROM SMCP 

%11-DISK FILE HEADER NOT PRESENT 

%12-INVALID FILE ACCESS 

%13-VARIABLE RECD SIZE BELOW BOUNDS 

%1 WAR I ABLE RECD SIZE ABOVE BOUNDS 

%15-VARIABLE RECD SIZE INVALID ON INPUT 

%16=USER DATA OUTSIDE BASE-LIMIT 

%17-EMULATOR TAPE IRRECOVERABLE EXCEPTION 

%18-EMULAT0R TAPE ILLEGAL INITIATE 

%19-EMULATOR TAPE ILLEGAL FETCH 

%20-EMULATOR TAPE OVERLAP 

%21=EMULAT0R TAPE ILLEGAL OPCODE 

%22-EMULATOR TAPE ILLEGAL ERROR MASK 

%23-EMULATOR TAPE ILLEGAL ACCESS 

%25-Record size invalid on variable length rewrite. 

%25=Linage page overflow. 

%26=lnvalid communicate on printer file. (Linage 

% communicate error.) 

%28=C0NSECUT1VE REWRITE ERROR (Rewrite must be proceeded 

% by a read.) 

%29=EXCEEDED MAXCARDS LIMIT 

%30-EXCEEDED MAXLINES LIMIT 

%31«lnitiate serial protection. 

% 

% **** Type 10 **** Relative file problem. 

% ** and relative communicate ** 

%71-lnitiate SYSTEM/F I LE- INIT to initialise blocks of an 

% area. 

%72-Next area required. 

%73'°'rival id communicate for file. 

%7t=End of file/page. 

^T'S^'Boundary violation. 

%7o=lnval id key. 
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•Dupl icate key. 
"Boundary violation. 

%e1se as for type 1. 

% 

% ***ft IS communicate **** 

% l=Memory buffer needed. 

% 2=Split fine table. 

% 3"Next area needed for data file. 

% It"Update coarse tables. 

% 5"Mal<e structure present. 

% D-Create current. 

% 7=15 audit writes. 

% 

%50=inva1id key on IS start. 

%51=Dupl icate key. 

%52=l nval id key. 

%53=End of file/page. 

%5^=Sequence error. 

%55=Dupl icate key ok??????????????????????? 

%5D=i ntegr i ty error. 

% 

% Fatal errors. 

%91»lnvalid access mode. 

%92=Read on output only file. 

%93=Rewr i te on non I/O file. 

%9^=Write to non output file. 

%95-Delete on non I/O file. 

%9D=Rewrite not preceeded by read. 

%97"Delete not preceeded by read. 

%9o°lriival id communicate. 

%99'°' I f recover able write error. 

%100«Sequential read after dynamic invalid key. 

% 

% **** TYPE 21 **** Gismo Terminate. 

% 1-CWG FROM NON-MCP 

% 2-NON-MMCP CALLED CHECK. lOD 

% 3-COMMUN I CATE OUTSIDE BASE/LIMIT 

% If=INVALID PORT IN DIRECT 10 DESCRIPTOR 

% 5-EXCEEDED DATA OVERLAY DISK SIZE 

% 

% **** TYPE 22 **** Environment not present. 

% USE VALUE FROM COMM SPLITTER MASK CORRESPONDING 

% TO ENVIRONMENT TYPE 

% 

% ft*** TYPE no **** Port, queue or remote problem. 

% 1=1 nval id key. 

% 2=No end of file provision. 

% 3=Number of stations declared in FIB exceeded. 

% 4=No provision for terminate error. 
END 
END, 
RS ODT Q KEY BIT(2lf) , 

~ ~ %POINTS AT THE QUEUE DESCRIPTOR DESCRIBING THE USERS 

%ACCEPT QUEUE 
RS FILE BIT{8) , 

%IF THE JOB IS HUNG FOR ANY PROBLEM WITH A FILE, THIS 

^CONTAINS THE INDEX INTO THE FIB DICTIONARY FOR THE 

%FILE IN QUESTION 

%IF THE JOB IS HUNG FOR NO DMS_FILE, then the RS_DMS_FILE 

% field at the end of rsn Tnew for 12.0) is used to 

% describe which file is needed. Previously, this field 

% was used to index into the structure dictionary 
RS RUN UNIT BIT(16) , 

~ ~ %JOB NUMBER OF THE PARENT OF THIS RUN UNIT (FOR IPC) 
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RS_RUN_UNIT LINK BIT(l6) , 

%30B NUMBER OF THIS JOBS CALLER (FOR IPC) 
RS_IPC_PARAMETER LIST BIT(24), 

^ABSOLUTE ADDRESS OF THE IPC PARAMETER LIST 
RS_EXECUTE TYPE BH {k) ,~ 

f 1 ■= EXECUTE 

% 2 = COMPILE AND GO 

% 3 ■= COMPILE FOR SYNTAX 

% k " COMPILE TO LIBRARY 

% 5 «= COMPILE AND SAVE 

% 6 ■= GO PART OF COMPILE AND GO 

% 7 ■= GO PART OF COMPILE AND SAVE 

% 8 = CALLED (IPC) 
RS_NAME NAME RECORD, 

%NAME OF THIS JOB 
RS_IPC_EVENT BOOLEAN, 

%DUMMy EVENT FOR ANY HANG FOR IPC 
RS_CANCELED BOOLEAN, 

%A CANCEL COMMUNICATE HAS BEEN ISSUED AGAINST THIS JOB 
RS_EVENT_SPACE B I T (24* 1 7) , 

^REPRESENTS THE LIST OF EVENTS ON WHICH A JOB IN THE 

%WAIT_Q IS WAITING 
RS FREEZE BITS RECORD 

RS_BOl TO EOJ FREEZE BOOLEAN. 

flF~TRUr, JOB WAS EXECUTED WITH FREEZE AND CAN NEVER BE 

%ROLLED OUT 
RS SORTER OPEN BOOLEAN, 

%TRUE IF THIS PROGRAM HAS A READER-SORTER OPEN. THE 

%READER-SORTER MAY OR MAY NOT BE FLOWING. 
RS TEMPORARY FREEZE BIT (7) 

~ ^COUNTlR THAT IS BUMPED EACH TIME A FREEZE IS DONE AND 

^DECREMENTED FOR EACH UNFREEZE. CHANGED BY FREEZE 

^COMMUNICATE, REMOTE FILE OPEN. INITIALIZER I/O. MICR 

%OPEN AND CLOSE 
END. 
RS_LOG PTR DISK ADDR. 

~ %DISK ADDRESS OF WORKING PFB AND FPB-S 
RS JOB ACCTING NO BIT(2lt) , 

%A URIQUE ID NUMBER FOR EACH JOB. RESET ONLY BY 

%COLDSTART. INCREMENTED BY 1 EACH TIME A JOB ENTERS THE 

^SCHEDULE. USED BY TABS. 
RS_NUMBER FILES BIT (8) , 

~%MAXIMUM NUMBER OF FPB-S DECLARED BY THIS PROGRAM. 
RS_TYPE HDWR TYPE, 

%HARDWARE TYPE REQUIRED TU RESOLVE MISSING HARDWARE 
RS TRACE_FIB BIT(8) , 

%FILE NUMBER USED FOR TRACE. INDEX INTO THE 

%FIB DICTIONARY 
RS_SER NO " BIT (24) , 

%SERIIAL NUMBER OF A DISK PACK IF THIS JOB IS WAITING 

%FOR A BASE OR CONTINUATION PACK FOR MULT I PACK FILES 
RS_UNIT_INDEX BIT (24), 

%ADDRESS OF lOAT OF DEVICE INDICATED BY IL.OU.FM.UL 
RS_MCP_USE BOOLEAN, 

%IF TRUE, MCP IS WAITING FOR AN EVENT FLAGGED BY 

%RS BOOLEANS TO OCCUR 
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RS BOOLEANS RECORD 

%USED BY THE SMCP TO INDICATE ACTIONS AVAILABLE TO 
%SOLVE OPEN AND CLOSE PROBLEMS 
RS IL BOOLEAN, 

RS~UL BOOLEAN, 

RS~OF BOOLEAN, 

RS~FR BOOLEAN, 

RS~FM BOOLEAN, 

RS~OU BOOLEAN, 

RS~OK BOOLEAN, 

RS~RM BOOLEAN, 

RS~MR BOOLEAN, 

FllLER BIT(15) 

END, 
RS MEMORY PRIORITY BIT(ii), 

"%MEMORY PRIORITY - 0-15 ALLOWED 
RS SWEEPS BEFORE DECAY BIT(IO), 

~%NUMBER of MEM_SWEEP INTERVALS BEFORE IMPORTANT CODE 
%SEGMENTS WILL DECAY" 
RS FORCED SUSPENSION BOOLEAN, 

~%IF TRUE, JOB HAS BEEN STOPPED BY AN "ST EOJ". MESSAGE 
RS LENGTH BIT(2lt) , 

^LENGTH IN BITS OF THIS RUN STRUCTURE 
%INCLUDES RS NUCLEUS, FIB DICT, 
%IPC DICT, IR PARAMETER TABLE, 
%0VEWLAY DESCRIPTOR 

rs protected boolean, 

%if true, job is locked - need lp- to ds 
rs to be stopped boolean, 

~ ~ ~ %if true, an st was issued on this job. it is to be 

^stopped when convenient 
rs stopped boolean, 

%if true, job has been stopped by st 
rs emulator tape bit(8) , 

%tiumber of emulator tape files currently open 
rs gismo proc lock boolean, 

" %foRmerly rs_priviliged. now in a rib. 
RS apparition boolean, 

%IF true, THIS JOB HAS CALLED ANOTHER JOB VIA SORT OR 
%PGM caller and IS waiting FOR ITS COMPLETION 

FILLER ~ BIT (67), 

^FORMERLY RJE INFORMATION WHICH NOW RESIDES IN A RIB. 

RS PRIOR JOB NO BIT(l6) , 

~ %JUB number of job THAT INVOKED THIS JOB THROUGH 

%pgm caller or sort 

RS OVLY DESC PTR bit (24) , 

~ %AnDRESS OF RESULT DESCRIPTOR OF OVERLAY DESCRIPTOR 
RS PSEUDO READER BIT (24) , 

~%ADDRESS OF PSEUDO READER ASSIGNED TO THIS JOB 
RS DUMMY EV BOOLEAN, 

~ %A GENERAL PURPOSE EVENT USED BY COOPERATING PROCESSES 
%WITH1N THE SMCP TO HANG A JOB AND CAUSE IT TO BE MOVED 
%T0 THE SMCP-S COMM QUEUE 
RS MAX TIME ~ BIT (24) , 

~ ~ % IF <> THEN PROCESSOR TIME IN lOTH OF SECONDS THAT 
% THIS JOB IS ALLOWED TO RUN. ONLY APPLIES TO PRIMARY 
% ENVIRONMENT 
RS IN TRANSACTION BOOLEAN, 

" ~ %JOB IS IN DMS TRANSACTION STATE 
RS DM OPERATION BOOLEAN, 

~ ~ %JOB HAS A DMS OPERATION IN PROCESS - 
^CANNOT BE ROLLED OUT 
FILLER BIT(24), 
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RS DMS GLOBALS BIT(2it) , 

" ~ %ADDRESS OF DMS GLOBAL SPACE 
RS MFID CHANGED BIT(2) , 

~ %MUST SHIFT NAME LEFT ONE NAME BECAUSE OF USERCODE 
RS PKID CHANGED BOOLEAN, 

~ %MUST DELETE THE PACK ID IN THE NAME 
RS 110 IN PROCESS BOOLEAN, 

~ ~ ~% INDICATES INITIALIZER I/O IS IN PROCESS 
RS MCS FILE NUMBER RECORD 

~ RS'MCS FL bit (8) % JUST A TEMP NAME 

~ SMCS file number FOR COBOL?^ PARTICIPATING OUTPUT. 
%IS A COBOL 7k PROGRAM DOING DATA COMM 
END, 
RS TRACE TO BE STOPPED BOOLEAN, 

~ %CNI:"MEANS trace FILE WILL BE CLOSED NEXT TIME INTERP 
%DOES A WRITE TO THE TRACE FILE 
RS CHARGE NUMBER BIT (24), 

~%THIS JOBS CHARGE NUMBER 
RS pseudo_runner BOOLEAN, 

~ % job to be made very transparent- no BOJ, EOJ, etc. 
FILLER BIT(3), 

^FORMERLY RS_RESTRI CTIONS. NOW IN A RIB. 
RS BNA ZIP BIT(l) , 

~ ~ ^PROGRAM ZIPPED AN "AT" CONTROL CARD COMMAND 
RS JOB TASK MIXNUMBER BIT(l6), 

~ ~ %HlX NUMBER OF THE JOB TASK 
RS PARENT TASK NUMBER BIT(2it), 

~%TASK NUMBER OF THE PARENT TASK 
RS PRIVATE TASK BOOLEAN, 

:EN0 INQUIRIES MAY BE MADE OF THE TASK OR FILE ATTRIBUTES 
RS TASK TYPE BITW , 

~ %TYPE OF TASK EXECUTION: 1 « ASYNCHRONOUS 
% 2 « SYNCHRONOUS 

% 3 = INDEPENDENT 

% It - JOB 

RS TASK NUMBER BIT(2if) , 

~ UASK VARIABLE NUMBER FOR THIS TASK 
RS OBJECT NUMBER BIT(8) , 

~%OBJECT TASK NUMBER FOR INDEPENDENT TASKING ONLY 
RS TASK VARIABLE TABLE ADDR BIT(24), 

" ^MEMORY ADDRlSS OF TABLE OF ALLOCATED TASK VARIABLES 
RS WFL TASK BOOLEAN, 

~ ~ ^INDICATES THIS TASK IS WITHIN A WFL JOB 
RS TASK VARIABLE DISK ADDRESS BIT(36), 

" %DISK TfDDRE^S OF THIS TASK'S TASK VARIABLE 
RS JOBSUMMARY HDR OFFSET RECORD 

%0FFSET~INT0 HDR DICT FOR JOBSUMMARY FILE - WFL JOB ONLY 
RS TASK SCRATCHPAD BIT(2it) 

%HlSC USE FOR TASKING 
END, 
RS ENFORCE MAXCARDS BIT(l), 

^ENFORCE THE LIMIT ON MAXCARDS 
RS ENFORCE MAXLINES BIT(l), 

fENFORCE THE LIMIT ON MAXLINES 
RS CURRENT CARDS PUNCHED BIT (24), 

SCURREffT COUNT OF NUMBER OF CARDS PUNCHED 
RS MAXCARDS BIT (24) , 

^MAXIMUM NUMBER OF CARDS TO PUNCH 
RS CURRENT LINES PRINTED BIT(24), 

^CURRENT COUNT OF NUMBER OF LINES PRINTED 
RS MAXLINES BIT(24) , 

%MAXIMUM NUMBER OF LINES TO PRINT 
RS MAX ELAPSED TIME BIT (24) , 

" ~ %MAXTMUM ELAPSED TIME ALLOWED 
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RS SCHED DATE BIT (36) , 

%YEAR MONTH DAY HOUR MINUTE SECOND WHEN SCHEDULED 
RS_INVISIBLE BIT(I), 

%INViSI6LE IN MIX 
RS_GO_EVENT BIT(l), 

%SPECIAL EVENT FOR "ST" 6 "GO" 
RS ST EOJ SPECIFIC BIT(l6) , 

~ ~ ~% ALLOWS US TO STOP JOB UNTIL EOJ OF A SPECIFIC OTHER JOB. 
RS DD SIZE BIT(2if), 

~ ~ % NUMBER OF DATA DECKS PRESENT FOR TASK 
RS DD ADDR BIT(2it), 

" ~ % DATA ADDRESS OF THE DATA DECK NAMES 
RS MASTER BLOCKED CNT BIT(6), 

~ % number of blocks on the master scheduler for this job 
RS PORT EVENT BOOLEAN, 

~ % HANG EVENT FOR "BNALIO OPEN". FORMERLY A BIT IN RMSGP 
RS DMS TIME BITT20), 

~ ~ % ACCUM DMS TIME EXCEPT FOR CURRENT ENV. (FOR DMS LOGS) 
RS DMS FILE RECORD 

~ " % THIS FIELD REPLACES THE USE OF RS FILE TO COMMUNICATE 
% WHICH DMS RELATED FILE IS THE OBJlCT OF A 
% HANG NO FILE (WE DID IT WRONG ANYWAY). ONLY ONE OF 
% THE THREE FIELDS SHOULD BE IN USE AT A TIME 
RS DMS AUDIT FILE BOOLEAN, 

" ? THE HISSING FILE IS THE AUDIT FILE 
% (OVERRIDES RS DMS STRUCTURE FILE) 
RS DMS DICTIONARY FILE" BOOLEAN, 

" ? THE MISSING FILE IS THE DICTIONARY 

% (OVERRIDES EITHER OF THE OTHER FIELDS) 
RS DMS STRUCTURE FILE STR_PTR %bit 10 in 12.0 
END, - - - 

* (ONLY RELEVANT IF OTHER TWO FIELDS ARE FALSE) 
RS LOG MIX PPB OFFSET BIT(l6), 

~ " « THi: OFFSET OF THE PPB COPY IN THE LOG MIX INFO TABLE. 
% ONLY VALID IF THE LOG OPTION IS SET. 

RS ORIGINAL RIB ROUTING INFORMATION BLOCK, 

%"THE ORIGINAL ROUTING INFORMATION FOR THE JOB. 

RS CURRENT RIB POINTER ROUTING INFORMATION BLOCK, 

f THE CURRENT ROUTING INFORMATION OF"THE JOB. 

RS SERVER QUEUE EVENT BOOLEAN; 

~l COMPLEX WAIT EVENT TYPE 10 FOR RIB SERVER QUEUES 



CONSTANT RS N SIZE - TYPE LENGTH (RS NUCLEUS); 
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ENVIRONMENT STRUCTURE NUCLEUS 

The environment structure nucleus (ESN) permits special system code files to be attached to a task. 

The Environment Structure Nucleus as well as the run structure nucleus (RSN) of a program are gener- 
ated by the SMCP at the beginning of a job. The RSN contains pointers to the file dictionary of the 
job and environment dictionary. The ESN contains pointers to the code dictionary and data dictionary 
of the job. 

Neither the RSN nor the ESN is ever rolled out of memory. The RSN is never moved. The ESN is 
contiguous with the local data and is moved during rollout. 

A programmatic description of the ESN follows. 

% 

CONSTANT ES_N_SIZE - 905? 

RECORD 

1 ES NUCLEUS BtT(ES N_SIZE), 

2 IS COMMUNICATE MSG PTR BIT (487, 

%CONTAlHS EITHER AN SDL DESCRIPTOR THAT POINTS TO A 
^COMMUNICATE MESSAGE OR THE MESSAGE ITSELF 
3 ES MSG PARAMETERS BIT(2U), 

It Is CUMM MSG KEY BIT(8) , 

5 rs ITYPE " BIT (2) , 

%UEFINES the use of communicate MSG PTR 

- program internal interrupt 
= communicate 

- undefined 
= terminating 

BIT(6), 

%Tnterrupt number if ES_ITYPE-00 

k ES I LENGTH BIT (16) , 

"%LENGTH OF COMMUNICATE MESSAGE IF ES_ITYPE=01 
3 ES {ADDRESS BIT (24) , 

~ %ADDRESS OF COMMUNICATE MESSAGE IF ES ITYPE = 1 

%IF ES ITYPE = 3 THEN MAY CONTAIN ERRUR COUNT OR TYPE 
%SEE IH FOR DEFINITION WHEN ES ITYPE - 
ES REINSTATE MSG PTR BIT (487, 

%SELF-RELiifTIVE SDL TYPE DESCRIPTOR USED TO PASS THE RESULT 
%0F A COMMUNICATE FROM AN MCP TO AN ENVIRONMENT 
%SEE EACH COMMUNICATE FOR DEFINITION OF VALUES 
3 ES RMSG PI BIT (24) , 

3 ES~RMSG P2 BIT (24)., 

ES R^N ADURESS bit (24) , 

~ ~%ADDRESS OF THE RSN FOR THIS ENVIRONMENT 
ES MY BASE BIT (24) , 

~ ~ %BASE REGISTER FOR THIS ENVIRONMENT 
ES MY LIMIT B1T(24) , 

" " %LIMIT REGISTER FOR THIS ENVIRONMENT 
ES LOCAL DATA ADDR BIT(24), 

%7JBS0LUTE ADDRESS OF THE LOCAL DATA SPACE FOR THIS 

^ENVIRONMENT. 

%NOTE: THE LOCAL DATA SPACE MAY NOT COINCIDE WITH THE 

%BASE-LIMIT AREA 



% 


00 


% 


01 


!i: 


10 


% 


11 


ES 


INMBR 
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2 ES NIP BIT (32) . 

%PAGE, SEGMENT AND DISPLACEMENT OF THE NEXT EXECUTABLE 
% INSTRUCT I ON FOR THIS ENVIRONMENT 
3 ES NIP SG PG BIT{12) , 

~ % SDl - (ES PAGED_DICT TRUE) 
4 ES NIP SG BIT(6) , 

k ES~NIP PG BIT (6) , 

3 ES NTP SIG REMAPS ES NIP SG PG BIT(IO), 

% NON SDL 
3 ES NIP DISP BIT (20) , 

2 ES_SFG DTC PTR bit (24) , 

%ADnRESS OF THE MASTER CODE SEGMENT DICTIONARY FOR THIS 
^ENVIRONMENT 
2 ES_DATA_DIC_ADDR BIT(2if), 

%ADDRESS OF THE DATA SEGMENT DICTIONARY 
2 ES_SPAD PTR BIT(2i») , 

f ADDRESS OF SCRATCH PAD IN S-MEMORY 
2 ES INTERP ID BIT(5) . 

%lfrTERPRETER NUMBER FOR THIS ENVIRONMENT 
% INDEX INTO THE INTERPRETER DICTIONARY 
2 ES BOOLEANS BIT (23) , 

3 Is CONTROL STATE BITS BIT (2). 

% THE^E TV/0~MUST REMAIN IN THIS ORDER FOR GISMO'S BENEFIT 
k ES MCP BIT BOOLEAN. 

%INTJ|CATES TO THE INTERPRETER THAT THIS IS THE SMCP 
k ES CONTROL STATE BOOLEAN, 

~% INDICATES TO THE INTERPRETER THAT THIS ENVIRONMENT 
%BE LONGS TO A CONTROL STATE JOB 
3 ES MEDIA BOOLEAN, 

~ % IF SET, THEN THE LOCAL DATA AREA IS PRESENT, 
% OTHERWISE IT IS ROLLED OUT TO DISK 
3 ES LINKS BOOLEAN, 

~ %IF TRUE, DYNAMIC SPACE CONTAINS MEMORY LINKS 
3 ES SIZECHANGE BOOLEAN, 

%IF TRUE, THE SCRATCHPAD FOR THIS ENVIRONMENT IS 
%BEING CHANGED 
3 ES SD PTR FLAG BOOLEAN, 

f - ES SEG Die PTR CONTAINS ADDRESS OF DICTIONARY 
% CORTAIUER ~ 

% 1 - es seg die ptr contains address of segment 
% diUtioFIary~itself 
3 es intrin aggr used bit(2), 

~ % SAHE AS"PR0G INTRIN AGGREGATE IN THE PPB 
3 ES DONT REENTER " ~ BOOLEAN, 

%\T TRUE. THIS ENVIRONMENT CANNOT SHARE ITS SEGMENT 
^DICTIONARY 
3 ES_PAGED DICT BOOLEAN, 

% INDICATES THAT CODE SEGMENT DICTIONARY IS PAGED 
3 FILLER BIT(12) , 

% FOR EASY ADDITION OF FLAGS 
2 ES_PAGED ARRAY OVERLAY BIT (6), 

%^EGMENT number of THE SDL PAGED ARRAY HANDLER OVERLAY 
%IF REQUIRED FOR THIS ENVIRONMENT - ALWAYS PAGE 
2 ES_LAST ENVIRONMENT BIT(l6), 

^NUMBER OF THE ENVIRONMENT THAT CALLED THIS ONE 
%USED BY THE EXIT ENVIRONMENT COMMUNICATE 
2 ES_SPAD SIZE " BIT(l6) , 

?S1ZE IN BITS OF SCRATCH PAD FOR THE M-MACHINE. 
%FOR BI7OO/BI8QO IT WILL BE 768 
2 ES INTERP DATA SIZE BIT (24), 

^LlNGTH IN BITS OF INTERPRETER DATA SPACE 
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2 ES_INTERP DATA ADDR BIT(2it), 

^ABSOLUTE ADDRESS OF INTERPRETER DATA SPACE 
2 ES_LOCAL DATA SIZE BIT (24), 

%rENGTH IN BITS OF THE LOCAL DATA SPACE FOR THIS 

%ENVIRONMENT 
2 ES_TRACE BITS BIT (8) , 

%RAGS INDICATING WHAT TYPE OF TRACE IS TO BE PERFORMED 

%THE TRACE BUFFER IS GLOBAL TO THE PROCESS, BUT THE TRACE 

%BITS ARE LOCAL TO EACH ENVIRONMENT. 

^INITIALLY IT WILL ONLY BE POSSIBLE TO SPECIFY TRACE 

%BITS FOR THE PRIMARY ENVIRONMENT, EXCEPT VIA MODIFY 

% ON THE CODE FILE, OR PROGRAMMATI CALLY 
2 FILLER BIT(i+i»). 

2 ES DATA Die SIZE BIT(l6), 

?NUMSER OF DATA DICTIONARY ENTRIES 
2 ES PROG PTR DISK ADDR, 

IDISK ADDRESS OF THE CODE FllE FOR THIS ENVIRONMENT 

%MAY BE ZERO FOR SPECIAL ENVIRONMENTS SUCH AS I BASIC 
2 ES DISK DISK ADDR, 

^ROLLOUT DISK ADDRESS FOR THl LOCAL DATA 
2 ES LENGTH BIT(21|) , 

%LENGTH IN BITS OF THIS ENVIRONMENT 

% INCLUDES LOCAL DATA, ES_NUCLEUS, DATA_DICT, 

^SCRATCH PAD 
2 FILLER ~ BIT (40) , 

2 ES DATA OVERLAYS BIT (24), 

^ADDRESS OF DYNAMIC SPACE WITHIN LOCAL DATA SPACE 

%FIRST LINK FOR MEMORY MGMT OF DATA OVERLAYS 
2 ES LAST LINK BIT (24) , 

^ADDRESS OF LAST MEMORY LINK WITHIN DYNAMIC SPACE 

%USED FOR MEMORY MGMT 
2 ES LAST OVLY BIT (24) , 

?LEFT OFF POINTER FOR MEMORY MGMT - USED ONLY FOR 

^ENVIRONMENTS WITH DATA OVERLAYS AND LINKS 
2 ES OVLY DISK BASE DISK ADDR, 

fDISK~ADDRESS OF BEGINNING OF DATA OVERLAY SPACE 
2 ES OVLY DISK PTR BIT (24) , 

flNDE^ INTO THE DATA OVERLAY AREA ON DISK 
2 ES OVLY DISK SIZE BIT (24) , 

^NUMBlR OF DISK SEGMENTS RESERVED FOR DATA OVERLAYS 
2 ES PREVENT MOVE BOOLEAN, 

% \T TRUE. THIS ESN MAY NOT BE MOVED. 

% THERE ARE CURRENTLY NO CONDITIONS UNDER WHICH THIS 

% WILL BE SET. IT IS PURELY A 'FUTURES' FIELD. 
2 ES DISPLACED BIT(24) , 

%D I STANCE THE ESN HAS BEEN MOVED AS A RESULT OF ROLLOUT 
2 ES EMULATOR BITS BIT(4) , 

%USE!J BY THE B1700 EMULATOR 
2 ES ENVIRONMENT TYPE BIT(4), 

% = PRIMARY ENVIRONMENT (THE USER PROGRAM) - 1 ONLY 

% 1 - MCP ENVIRONMENT - FUTURE? 

% 2 = DMS ENVIRONMENT - CURRENTLY 1 ONLY 

% 3 - SPECIAL ENVIRONMENT - CURRENTLY 1 ONLY, FOR IBASIC 
2 ES TEMP PPB PTR DISK ADDR, 

f DI5K ADDRESS OF THE WORKINU PPB FOR THIS ENVIRONMENT. 

% WILL BE THE SAME AS RSN.RS LOG PTR FOR THE PRIMARY 

% ENVIRONMENT. ~ ~ 
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2 ES_INTERFACE ADDF* BIT(2lf), 

% REL~ADDRESS OF DMS INTERFACE AREA WITHIN DMCP'S LOCAL 
% DATA. ALSO USED AS AN ABSOLUTE ADDRESS OF TEMP INTERFACE 
% DURING OPEN, BEFORE DMS ENV IS ALLOCATED OR BEFORE 
% ES CONTROL STATE IS SET — WAS RS DMS INTERFACE ADDR. 

2 ES_FATALERRUR " BOOLEAN, - - 

% INDICATES DMCP HAS A FATAL OR DEBUG ERROR — 
% WAS Dl FATALERROR. 

2 ES_NON FATALERROR BOOLEAN, 

""% DMCP HAS A NON-FATAL ERROR 

2 ES RESOURCE COUNT BIT{l6); 

% NUHBER of resources DMCP HAS LOCKED. IF 0, PROGRAM CAN 
% BE DS'ED IMMEDIATELY, OTHERWISE RS_ABORT MUST BE SET ~ 
% WAS Dl DONT DS ME. 
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APPENDIX E 
MEMORY MANAGEMENT 



Figure E-1 shows global memory allocation and figure E-2 shows linked memory allocation. The 
paragraphs that follow the figures provide (1) a description of the fence within linked memory and 
(2) a discussion of the manner in which the SMCP program attempts to minimize memory checker- 
boarding. 

Programmatic descriptions of a system descriptor (used in code and data dictionaries) and of a memory 
link (describes a memory segment) complete the appendix. 
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GISMO work area 
interrupt queue 



GISMO code 



Micro MOP data space 



MCP run structure nucieus 



MCP environment structure nucleus 



Upper terminating memory link 



Memory Link 



Lower Terminating Memory Link 



MCP code segment 1,0 



Correctable error table 



Cold start variables 



Interpreter dictionary 



MCP page zero dictionary 



MCP code dictionary master 



MCP stacks, includes 

MCP global data, also known as Hints 



Maximum 
Address 



^ 



^ 



Linked 
Memory 



Address Zero 



Figure E-1. Global Memory Allocation 
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Upper Terminating Memory Link 



IVIL 



SDL2 interpreter global segment 



ML 



Disk and ODT descriptor chain head 



ML 



SYSTEM/ODT segment dictionary 



ML 



Input/output assignment table 

Unit test descriptors 

Tape descriptor chain head 



ML 



I/O channel tables 



ML 



Communicate splitter mask and Truth table 



ML 



Micro MCP segment dictionary 



ML 



SDL2 interpreter segment dictionary 



ML 



Extended result descriptors 



ML 



Queue information global parameters 



ML 



Queue descriptors 



ML 



SMCS segment dictionary 



ML 



Network controller segment dictionary 



ML 



Disk cartridge/pack information table 



ML 



Disk file header dictionary 



Fence 



ML 



Lower Terminating Memory Link 



Figure E-2. Typical Linked Memory Allocation 
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THE FENCE 

Within linked memory, the location called the fence is used to guarantee that there is always room 
in memory for the largest SMCP code segment and segment dictionary for that page. If the SMCP 
program were performing an operation and did not have room to bring in a required code segment 
and the segment dictionary, the system would have to halt. 

Simply using the largest SMCP code segment is not good enough because a shorter SMCP code seg- 
ment could have a longer dictionary; thus the combination of the two could be longer. 

To calculate the location of the fence, add the bit length of the largest MCP code segment for its page, 
the bit length of the segment dictionary for its page, and the bit length of three memory links to the 
memory address of the lower terminating memory Unk. 

MINIMIZATION OF CHECKERBOARDING 

Checkerboarding, also known as "external fragmentation," is a condition in which the disk contains 
many permanently allocated save areas separated by small overlayable areas. In such a situation, there 
may be no contiguous overlayable area large enough to service a given request, even though the small 
areas aggregate to more total area than is needed. This situation has a serious impact upon system 
performance. 

To minimize checkerboarding, the SMCP program allocates non-over layable, or "save," memory seg- 
ments at the high end of Unked memory. Examples of such segments are program run structures, user 
files, and disk file headers. 

SEGMENT DICTIONARIES AND SYSTEM DESCRIPTORS 

Virtual memory is supported by allowing process segmentation. By segmenting code, data, and interpre- 
ters and dynamically moving a segment into or out of memory as required, the system functions as 
though it has almost infinite memory capacity. The MCP manages this facility through three structures: 
Code segment dictionaries, data segment dictionaries, and interpreter segment dictionaries. Each dic- 
tionary consists of a string of system descriptors, each of which describes one segment, including its 
length, location, and status. As a segment is moved in or out of memory, its dictionary entry is up- 
dated accordingly. 

At run time the MCP creates the code and data segment dictionaries from information in the 
program's code file. The interpreter segment dictionary is created from the interpreter code file in the 
same manner and is referenced by an entry in the interpreter dictionary, a structure fixed in memory 
at CLEAR/START time. The run structure of the program contains pointers to the code and data 
segment dictionaries and an index into the interpreter dictionary. 

A programmatic description follows. 
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RECORD 
01 



SYSTEM DESCR 
02 SY TN use 
02 SY STATUS 

03~SY_MEDIA 

03 SY_LOCK 

03 SY IN PROCESS 



02 SY INITIAL 



BIT(SY SIZE) , 

BOOLEAFI, % TO HELP MEMORY MANAGEMENT 

BIT(3), 

BOOLEAN,* 0=DISK, 1=S-MEM0RY 

BOOLEAN, % 

BOOLEAN, % 
% 



02 SY FILE 



BOOLEAN, 



BOOLEAN. 



02 


SY DK FACTOR 


BIT{3) 


02 


SY SEG PG 


BIT(7) 
BIT(i.) 


02 


SY~TYpr 



02 SY ADDRESS 
03 FILLER 
03 SY CORE 

02 SY LERGTH 



BIT 36 . 
BIT 12), 
BIT(2M, 
BIT(2lf) ; 



TRUE IF THERE IS AN I/O IN 
PROCESS FOR THE INFORMATION 
REPRESENTED BY THIS DESCRIPTO 
IF TRUE, "SY.CORE" CONTAINS A 
POINTER TO THE I/O DESCRIPTOR 
"ADDRESS" IS READ-ONLY MOTHER 
COPY, HENCE IF "WRITE" THEN 
GET NEW DISK AND REPLACE AD- 
DRESS. THE OBJECT OF THIS 
DESCRIPTOR IS A FILE WHOSE 
USERCOUNT MUST BE DECRENENTED 
WHEN THIS DESCRIPTOR IS 
RETIRED. 

MEMORY DECAY FACTOR 
MCP MEMORY ACTIVITY AUDITING 
UNITS FOR SY. LENGTH. 



8 = 



BITS 

DIGITS (i» BIT) 
CHARACTERS (8 BIT) 
NORMAL DESCRIPTORS 
DISK SEGMENTS 
SYSTEM DESCRIPTORS 
SYSTEM INTRINSIC 
INDIRECT REFERENCE 
ADDRESS GIVES RELATIVE 
DISPLACEMENT IN BITS 
(SIGNED NUMBER) . 
MICROS 



PORT, CHANNEL AND UNIT. 
CORE, OR ADDRESS WITHIN 
NUMBER OF UNITS, AS 
DETERMINED BY SY.TYPE. 



UNIT. 
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MEMORY LINKS 

The SMCP program organizes and allocates space in memory through the use of fields known as mem- 
ory links. Each link immediately precedes the block of memory it describes. The link contains such 
information as the disk address from which the memory was loaded, a pointer to the dictionary entry 
for the memory segment, the number of the job using the segment, the type of use of the segment, 
whether or not the segment can be overlaid, and pointers to the preceding and following memory links. 

The following describes some of the different things that can happen to a memory segment beginning 
with the time before it is allocated and ending with the time it is deallocated: 

Initially, the memory segment is available. 

It is allocated. 

It is swept by the GISMO firmware if the MPRI system option is set. 

It is passed over for overlay. 

It is overlaid (reallocated). 

It is deallocated and becomes available again. 

A programmatic description of a memory link follows. 



CONSTANT MEMORY_LINK_SIZE = l85; 



RECORD 



BIT (MEMORY LINK SIZE) , 

UlSK ADDR, 
BIT(ir7) , 
ADDRESS. 
BIT(16) , 
BIT(6). 
BOOLEAN. 



1 MEMORY_LINK 
2 ML DISK 
2 ML GROUP 

3 ML POINTER 

3 ML JOB NUMBER 

3 ML TYpr 

3 ML"SAVE 
2 ML SIZE BIT(2if), 

2 ML~PRIORITY FIELD BIT(28). 

3 HL DK INTlRVAL BIT (10) . 

3 ML'CURRENT DK INT BIT(lO). 

3 MLllNCOMINlJ_PRlORITY BIT(it), 

3 ML RESIDENCE PRIORITY BIT(M. 
2 ML FRONT ADDRESS, 

2 ML~BACK ADDRESS, 

2 ML~USAGE BITS BIT (2), 

3 HL PREVIOUS SCAN TOUCH BOOLEAN, 

3 ML~CURRENT 5CAN TOUCH BOOLEAN; 



% FROM SY_ADDRESS FIELD 

% OF DICTIONARY ENTRY 
% OF JOB USING SEGMENT 
% OF MEMORY SEGMENT 
% TRUE IF NOT OVERLAYABLE 
% SEGMENT SIZE IN BITS 



% OF FOLLOWING LINK 
% OF PRECEDING LINK 



E-6 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Memory Management 



MEMORY LINK TYPES 



SET ML TYPE SET MEMBER (6) 


m 










COUE 




0, 






DATA 




1 








AVAILABLE 




2 








RN S 




i 








MCF TEMP 










USER FILE 




5 








SEG UlCTV 




6 








MICROCODE 




I 








DICT MASTER 










QUEUr DIRECTORY TYPE 




9 








MSG BUFFERV 




10, 






MESSAGE LIST TYPE 




11, 






1 S BUFFER ~ 




12. 






DTfTTf SEG 




\l: 






DMS BUFFER 








TERHI MATING LINK 




15' 






MCP PERM ~ 




16. 






PSR~MEM 




\l: 






MCP" 1 OAT 








DISK HEADER 




19. 






PACK~MEM 




20. 






SD CRTNR 




21. 






scHed mem 




22. 






SORT Hem 




11: 






DCH Hem 








MICROCODE NON OVERLAYABLE 




25. 






QUEUE AVL~BUF~V 




26. 






DMS DTSK HDR 




11: 






DMS~STRUCTURE 








DMS~TEMP 


= 


29. 






DMS'GLOBALS 


s 


30. 






DMS~LOCK DESCR 


B 


31. 






ROUTING TNFO block 


S 


32. 






PERM ODT BUFF 


K 


11: 






DMS WORKAREA 


S 






1 S CURRENT 


s 


35. 






IRTFRP DATA 


ss 


36, 






LOG MIX TABLE 


B 


11: 






1 S"STRIICTURE 


K 






RUN'UN I T 


= 


11: 






TASK VARIABLE TABLE 


S 


% ko 




SYSTFM ERROR TABLE 
% " ~ 
CONSTANT MAX ML TYPE = k] , 


= 


k^', 


% k] 












CAN IT GO BELOW FENCE 


= 


[CODE, DATA, AVAILABLE. 



SEG DICTV, 
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APPENDIX F 
INPUT/OUTPUT OPERATIONS 



The data structures the MCP uses to keep track of input/output operations are described in the first 
four parts of this appendix. The ways in which various input/output functions are performed are de- 
scribed in the last part. 

INPUT/OUTPUT ASSIGNMENT TABLE 

The MCP monitors the status of all peripheral devices that are attached to the system. To do this, 
it maintains information about the status of each device. The major portion of this information is kept 
in the input/output assignment table (lOAT). 

The lOAT allows the MCP to keep track of all peripheral units except the ODT and the various data 
communication devices. Each unit is identified by port, channel, and unit number as well as by a sym- 
bolic name. Various fields reflect the status of the unit; for example, AVAILABLE, SAVED, RE- 
WINDING, LOCKED. 

Following is a programmatic description of the lOAT. 



DEFINE 
RECORD 


IOAT_SIZE AS #528#; 






1 lOAT REC BITdOAT SIZE) , 




02 


UNIT 


Initial 


BIT ( 


'If'/ * 




03 ■ 


"UNIT HDWR 


BIT 1 




03 


UNIT~PCD 


BIT { 


12), % 




04 


UNIT~P0RT CHANNEL 


BIT ( 


J), % 






05 UNIT POWT 


BIT 1 


3). % 
4), % 






05 UNIT CHANNEL 


BIT 




04 


FILLER" 


BOOLEAN, % 




04 


UNIT UNIT 


BIT (4), % 




03 


UNIT~NAME 


CHAR (6) , 


02 


UNIT 


LABEI ADDRESS 


DSK ADR, 




03 


"FILLER 


BIT"{12), 




03 


UNIT PACK INFO 


ADDRESS, 


02 


UNIT 


RS ■" 


ADDRESS,* USER LIMIT REGISTER 


02 


UNIT 


"FLAG 


S 


BIT(36). 




03 


"UNIT 


AVAILABLE 


BOOLEAN, 




03 


UNIT 


"AVAILABLE INPUT 


BOOLEAN, 




03 


UNIT 


"AVAILABLE OUTPUT 


BOOLEAN, 




03 


UNIT 


WAIT FOR FfOT READY 


BOOLEAN, 




03 


UNIT 


■test~and~waiT 


BOOLEAN, 




03 


UNIT 


"SAVEU 


BOOLEAN, 




03 


UNIT 


"REWINDING 


BOOLEAN, 




03 


UNIT 


"EOF SENSED 


BOOLEAN. 




03 


UNIT 


"LOCKED 


BOOLEAN. 




03 


UNIT 


"LABEL SENSED 


BOOLEAN. 




03 


UNIT 


"LABEL~SENSED 


BOOLEAN. 




03 


UNIT 


"PRINT BACKUP 


BOOLEAN, 




03 


UNIT 


"PURGE" 


BOOLEAN. 




03 


UNIT 


"LOCK AT TERM 


BOOLEAN, 




03 


UNIT 


"TO Bl SJWEO 


BOOLEAN, 




03 


UNIT 


"FLUSH" 


BOOLEAN,* FLUSH TO EOF 




03 


UNIT 


"TAPEF 


BOOLEAN, 




03 


UNIT 


"DISKF 


BOOLEAN. 




03 


UNIT 


"STOPPED 


BOOLE 


AN, 
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02 
02 
02 
02 
02 
02 
02 



02 
02 

02 
02 



03 
03 
03 
03 
03 

03 
03 
03 



UNIT 

UNIT" 

UNIT" 

UNIT" 

UNIT" 

UNIT" 

UNIT" 

UNIT" 



TRANSLATE 

CTRL CARD USING 

REMOTE JOl 

"CLOSED" 

CLEARED 

MULT I FILE 

EOT ~ 

"TAPE FILE STATUS 



03 
03 
03 
03 
03 
03 



UNIT 

UNIT" 

UNIT" 

UNIT" 

UNIT" 

UNIT" 



TAPE XCH 

no trans tble 
ofRine Yet in use 

AUDIT - - - 
RESERVED BY AB 
LABEL OP" " 






RELEVANT ( ANSI) 
[BEG OF VOlUME 
BEG OF FILE) 
END OF VOLUME) 
END OF FILE) 
[PROCESS FILE 



02 UNIT DRIVE TYPE 



03 



% 
% 
% 
% 
% 
% 
% 
% 
UNIT 
% " 
% 
% 
% 
% 



VAlUE 

1 
2 



PRINTER 
■ 

1 

2 



•15 

UNIT STATUS 
UNIT~TO BE POWERED 
UNIT"PCl TRAIN 
FILLlR ~ 
UNIT JOB NUMBER 
UNIT FIB ADDRESS 
UNIT LABlL TYPE 

S - 
% 1 - 

% 2 - 

% I " 

UNIT TRANS TBLE ID 
UNIT~SAVED FOR lOB 



DCCl/2/3 

32X203 

32Xi»06 

64X203 

64X^06 

N/A 

N/A 

N/A 

N/A 
TYPE 

450-700 

1100 

NOT USED. 

1500 LINE 

NOT USED. 



BOOLEAN. 
BOOLEAN. 
BOOLEAN, 
BOOLEAN. 
BOOLEAN. 
BOOLEAN. 
BOOLEAN. 

BIT (3) ,« - NOT 
% 1 •= BOV 
% 2 - BOF 
% 3 - EOV 
% 4 -= EOF 
% 5 - PFB 
% BLOCK) 

% 7 - UNDEFINED 
BOOLEAN,* FOR MIS-MATCHED UNITS 
BOOLEAN, %PC-5 

BOOLEAN, %FOR ASSIGNED UNITS 
BOOLEAN, % DMS AUDIT TAPE 
BOOLEAN.% AUTO BACKUP 6.1 
BIT(3),« 0=@OOEOOXe ODD TRANS 

% l-@OOCOOXe ODD NO TRANS 
% 2-§00600X§ EVEN TRANS 
% 3-@00400X§ EVEN NO TRANS 
BIT (4) .% DISK ONLY 
DFCl DFC3 
N/A N/A 
SYS. MEM 5N 
N/A N/A 
IC-3 N/A 
lC-4 N/A 
IA-3 N/A 
1A-4 N/A 
N/A N/A 



DPC1/2 

N/A 

215 

225 

N/A 

207 

205 

206 

N/A 

BIT (4) 

LINE PER M 

LINE PER M 



NUTE 
NUTE 



PRINTER. 
PRINTER. 



OFF 



? iUentifies who 



OMITTED 
BURROUGHS 
USASI 
INSTALLATION 

BIT (8). 

BIT (16) 



PER MINUTE PRINTER. 

BIT (15), 
BOOLEAN, 
BOOLEAN. 
BIT (6). 
BIT(l6) , 
ADDRESS. 
BIT (2), 



%PC-5 TRAIN ID 



FILLER 

UNIT TEST DESC 



THIS DEVICE IS SAVED FOR 

WORD,% PLEASE DO NOT DISTURB 
BIT (DESCRIPTOR SIZE) ; 
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CHANNEL TABLE 

Another structure associated with peripheral management is the channel table, a structure for passing 
information between GISMO and the MCP. There is one channel table for each port. Each element 
of a channel table describes one channel of the port. 

The channel table reflects the status of a particular channel. Certain information passed to GISMO 
during a dispatch operation is used by soft I/O to manage the execution of that operation. Before 
GISMO passes control back to the MCP, certain fields that direct the course of action the MCP will 
take are updated. 

Following is a programmatic description of the channel table. 



RECORD 

01 CHANNEL TABLE 

02 BUSY ~ 

02 PENDING 

02 EXCEPTION IDLE 



02 TIMER DISPATCH 



BIT (48) , 
BIT( 1) ,% 
BIT( l) ,% 
BIT( 1) ,% 
% 
% 
% 
BIT( 1) ,% 
% 
% 
% 
% 
% 
02 EXCEPTION OVERRIDE BIT{ ^) ,% 

% 
% 
% 
% 
% 
% 
% 
BIT( 1) ,% 
% 
BIT( 1) ,% 
BIT( 1) ,% 
% 
BIT( 1) ,% 
% 
% 
% 
% 
% 
% 
02 ODT_DISPATCH_OVERRIDE BIT(l), 

% 
% 
% 
% 
02 DISK DEVICE B1T( 1) ,% 
02 FILLlR BIT( 1) ,% 



02 EXCHANGE 

02 OLD MODE 
02 INTlGRITY 

02 LINK ON EXCEPTION 



SET WHEN CONTROL IS BUSY. 
SET ON RECEIPT OF DISPATCH OPERATION. 
SET IF EXCEPTION OCCURS AND 
LINK ON EXCEPTION FALSE. 
INHlIlT^ DISPATCHES. 
RESET BY DISPATCH WITH OVERRIDE SET. 
SET BY MCP DURING CLEAR/START. 
IMPLEMENTS TEST AND WAIT OPERATIONS 
ON TAPE AND DISK CONTROLS. 
CAUSES GISMO TO INITIATE THE CHANNEL 
AT EACH TIMER INTERRUPT IF THE 
CHANNEL IS NOT BUSY. 
SET BY MCP TO CLEAR TEST £ WAIT ON 
ODT OR DATACOMM, TO CLEAR A HUNG CON- 
TROL OR TO PROCEED AFTER AN EXCEP- 
TION. IF SET AT DISPATCH, 
CAUSES GISMO TO RESET BUSY, PENDING, 
EXCEPTION IDLE AND EXCEPTION OVER- 
RIDE, AND THEN TO PROCEED WITH NORMAL 
DISPATCH. 

SET BY MCP DURING CLEAR/START. 
IMPLIES CHANNEL IS ON AN EXCHANGE. 
NOT USED 

SET TO INDICATE CHANNEL TABLE ENTRY 
INITIALIZED CORRECTLY. 
SET BY MCP DURING CLEAR/START 
FOR TAPE AND DISK ONLY. 
CAUSES GISMO TO KEEP LINKING THRU 
THE DESCRIPTOR CHAIN IF AN EXCEPTION 
OCCURS RATHER THAN SETTING THE 
EXCEPTION IDLE BIT TO INHIBIT FURTHER 
DISPATCHER. 

% IF SET AND EXCEPTION HAD OCCURRED 
OVERRIDE EXCEPTION AND PROCEED WITH 
DISPATCH. 

IF RESET AND EXCEPTION HAD OCCURRED 
INHIBIT DISPATCH AND RETURN ERROR 
TO CALLER. 
NOT USED PRESENTLY 
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02 TYPE 



BIT( 



02 LAST 


BIT! 


; v 


02 EXCHANGE PC 


BIT! 


7 


03 EXCHANGE P 


BIT! 


•2: 


03 EXCHANGE~C 


BIT! 


02 REF ADDR 


BIT! 


!2V 



k) ,% DEVICE TYPE, ONLY FOR DUMP ANALYSIS 

% - SERIAL DEVICE 

% 1 - DISK 

% 2 - TAPE 

% 3 = CASSETTE 

% 4 - FLEXIDISK 

% 5 " DATACOMM 
,% DELIMITS CHANNEL TABLE 
,% EXCHANGE PORT AND CHANNEL 
,% EXCHANGE PORT 
,% EXCHANGE CHANNEL 
;% ADDRESS OF DESCRIPTOR IN PROCESS 

% EXCEPT FOR TAPE AND DISK CHANNELS 

% WHERE IT IS ADDRESS OF HEAD OF CHAIN. 



F-4 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Input/Output Operations 



INPUT/OUTPUT DESCRIPTOR 

The following is a programmatic description of an input/output (I/O) descriptor as seen in the disk 
descriptor chain and the tape descriptor chain. 



RECORD 

01 10 DESCRIPTOR BIT(272). 
02 ACTUAL END M ADDR, % 



02 RESULT 
03 BIT 



BIT (24 
BIT( 2 



% 

!:% 



03 
03 



FILLER 
BIT_3 



BIT( 
BIT( 



1).% 
% 



03 FILLER 
03 BIT 6 

02 LINK ~ 

02 10 OP 
03 IJP 



03 FILLER 
03 UNIT 

02 BEGIN 

02 END 

02 DISK 

02 M EVENTS 
03" IOC 
03 SIOC 
03 FILLER 
03 INT P OR 



IT( 1), 



Bl' 
Bl' 

M ADDR, % 
BTT(2i.). 
BIT( 3),% 
% 
% 
BITfl?). 
BIT( k) ,% 
M ADDR, % 
M ADDR, % 
BTT(21*),% 

BIT( 8" 

BIT( 

BIT( 

BIT 
S BIT( 



03 S_INT SENT 
03 M INT SENT 
03 FILLER 
03 INT S 
02 MCP lU 
02 FIB" 
02 FIB LINK 
02 BACR LINK 
02 P0RT~CHANNEL 
03 PORT 
03 CHANNEL 



BIT( 

BIT( 

BIT( 

BIT( 

BIT(16! 

M ADDR, 

M ADDR, 

M"ADDR, 

BTT( 7) 

BIT( 3) 

BIT 



POINTS TO END MEMORY ADDRESS WHEN OP 
COMPLETE. 

00 - READY TO DISPATCH FROM MCP TO G I SMO 

01 = INITIATED FROM G I SMO TO I/O CONTROL 

10 = OP COMPLETE, NO EXCEPTION 

11 = OP COMPLETE, EXCEPTION 

DEFINITION OF THE REMAINING 22 BITS VARIES 
DEPENDING ON WHETHER THE OP IS COMPLETE. 
THE FOLLOWING DEFINITIONS APPLY WHEN 
THE OP IS NOT COMPLETE 

RSF.INIT 

IF BIT_0_1 = AND BIT 3 = 1 AND BIT_6 ■= 1 

THE 10 DESCRIPTOR HAS BEEN INITIATED 

THE UNIT IS SEEKING 

RSF. DISK. DEVICE 

POINTS TO FOLLOWING DESCRIPTOR 



OOOx 
OlOx 
ETC 



READ 
WRITE 



UNIT NUMBER 

BEGINNING MEMORY ADDRESS FOR DATA TRANSFER 
ENDING MEMORY ADDRESS FOR DATA TRANSFER 
BEGINNING DISK ADDRESS FOR DATA TRANSFER 



% HARD 
% SOFT 



I/O 
I/O 



COMPLETE, 
COMPLETE, 



PHYSICALLY 
LOGICALLY 



% IF ON, CAUSE WAITING PROGRAM WHEN IOC 
% IF OFF, QUEUE SMCP INTERRUPT WHEN IOC 
% SMCP INTERRUPT QUEUED 
% NOT USED 



« QUEUE SMCP INTERRUPT WHEN IOC 

% CALLED I/O TYPE IN DUMP . 

% ADDRESS OF FIB ASSOCIATED WITH THIS 

% USED TO LINK MULTIPLE BUFFER FIBS 

% POINTS TO PREVIOUS DESCRIPTOR 



I/O 



% PORT 
% CHANNEL 
02 BEEN THRU ERROR BIT( 1); % SMCP 



TO WHICH OPERATION IS SENT 
TO WHICH OPERATION IS SENT 
HAS ALREADY HANDLED EXCEPTION 
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RESULT DESCRIPTORS 

The following are programmatic descriptions of non-test operation result descriptors for tape and disk 
devices. 



RECORD 

01 TAPE RESULT 
02 CORPLETE 
02 EXCEPTION 
02 NOT READY 
02 PARTTY 



BIT(15 
BIT( 1) 
BIT( T 
BIT( 1 
BIT( 1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
2 



02 


MEM ACCESS 


BIT 


02 


MEM PARITY 


BIT( 


02 


EOT" 


BIT( 


02 


BOT 


BIT( 


02 


WRITE LOCK 


B1T( 


02 


E F 


BIT( 


02 


rIwTnd 


BIT( 


02 


BLANK TAPE 


BIT{ 


02 


CRC ~ 


bit( 

BIT( 


02 


FILLER 


RECORD 




01 DISK RESULT 




02 


COMPLETE 




02 


EXCEPTION 




02 


NOT READY 




02 


DATTf PARITY 


02 


FILLlR 




02 


MEMORY PARITY 


02 


WRITE lOCKOUT 


02 


FILLEl 




02 


ADDRESS PARITY 


02 


SECTOR T^DDRESS 


02 


SEEK TTMEOUT 


02 


FILLlR 




02 


TRANSMISSION 



% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 



NON-TEST OPERATIONS 



BIT 

BIT 

BIT 

BIT 

BIT 

BIT 

BIT 

BIT( 

BIT' 

BIT 

BIT 

BIT 

BIT 




1 
2 



BIT(17) 



1 

1 

1 

1 

1 

1 

1 

2) 

1) 

1) 

1) 

?! 



9 

10 

n 

12 

13 & Tt 



% 

% 1 



% 


2 


% 


i 


% 


5 


% 


6 


% 


7 


% 


9 


% 


10 


% 


n 


% 


12; 


% 


15 



NON TEST OPERATIONS 



& 8 



13, 1^ 
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INPUT/OUTPUT FUNCTIONS 

Normal state programs request I/O functions in a symbolic fashion; for example, Write a Record. The 
MCP must transform these expressions into explicit I/O operators called I/O descriptors. An I/O de- 
scriptor allows the MCP to communicate directly with a peripheral device by means of the soft I/O 
routines of GISMO. GISMO manages the execution, by the I/O subsystem, of these operators. 

ALL I/O descriptors include fields providing such information as the type of I/O operation requested, 
source or destination memory addresses, and the device that is to execute the operators, as well as a 
field for result information used when control is returned to the MCP. Certain types of I/O descriptors 
also contain fields for information unique to their specific functions. 

Any number of I/O descriptors may be linked together to form a single chain, dispatched in one MCP 
operation to minimize the interaction of the MCP with the I/O subsystem. 

The multiline control is the only B 1000 device control that has a direct connection with main memory. 
For all other controls, all data transfers between the control and memory must go through the proces- 
sor. GISMO contains a set of microcoded routines with the primary function of interfacing between 
the MCPs (MMCP, SMCP) and the hardware. This allows the MCPs to view the I/O subsystem as 
an I/O processor. The MCPs can initiate I/O descriptors; GISMO handles initiation of the control, 
data transfer, and termination. The MCPs can queue several descriptors for execution by a control 
by properly setting the link fields in the descriptors; GISMO initiates each one in turn. 

User programs make requests to the MMCP. Sometimes, the MMCP must ask that the request be han- 
dled by the SMCP. In either case, the request is passed to GISMO, which, in turn, passes it to the 
I/O control. 

The I/O subsystem has the capacity for handling up to 15 controls (channels). GISMO initiates an I/O 
operation on a channel but does not wait for the operation to complete. It returns control to the re- 
questing channel. Consequently, more than one I/O operation may be in process at any given time. 
However, GISMO addresses only one channel at a time. 

The primary communication between the MCPs and GISMO is through the I/O descriptors. The 
SMCP dispatches I/O operations to GISMO using the DISPATCH S-operator. (The MMCP contains 
microcode to perform a similar function.) This S-operator requires two parameters, the port and chan- 
nel of the device being addressed and the memory address of the descriptor. The I/O descriptor con- 
tains all of the information needed by GISMO for the operation. 

An I/O descriptor is usually located by its Reference Address, which is the memory address of the 
result descriptor field of the I/O descriptor. (The result descriptor field is often referred to as the Re- 
sult Status (RS) field.) All the descriptors associated with a given control are linked together in memory 
by setting the LINK field in one descriptor to the memory address of the RS field of the next descrip- 
tor. The descriptors are also linked in the reverse direction through the BACK LINK field. This 

facilitates the adding and deleting of descriptors. A LINK field may not be zero but it may hold the 
memory address of the descriptor it is in. 

Each RS field is 24 bits in length, and the bits have different meanings at different times. When the 
descriptor is ready for initiation, the RS field is formatted as shown in table F-1. 
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Table F-1. Result Status Field 



RS Field 

Bits 0-1 RS Status Bits 



00 - Ready to be executed 

01 - I/O currently in process 

10 - I/O complete with no exception 

11 - I/O complete with exception 

Bits 2-11 Gismo Toggles 

MCPs may not alter any bits in this field if 
RS Status = 01. 

Bits 12-14 Port to which this I/O is directed. (Not used) 

Bit 15 Interrupt requested on I/O Completion. 

Bit 16 High-Priority interrupt requested on I/O 

Completion. 

Bits 17-19 Port to which interrupts are to be sent upon 
I/O Completion. (Usually processor 0.) 

Bits 20-23 Channel on which I/O is to be performed. 

The leftmost bit (bit 0) of an RS field is always set when the operation is complete. Consequently, 
storing a result descriptor locks the descriptor to GISMO. The MCP may lock a descriptor as well, 
if the status field does not contain 01. Gismo initiates only ready descriptors, descriptors with status 
bits equal to 00. When the operation is initiated, GISMO sets the status bits to 01. 

During an I/O operation, bits 2-11, designated GISMO Toggles, are used by GISMO to store informa- 
tion that it needs concerning the operation. 

GISMO/Hardware Interface 

The I/O descriptor contains most of the information GISMO needs to accomplish an I/O operation. 
In the actual hardware interface, the OP, BEGIN, END, DISK address and ACTUAL_END fields 
are used. The ACTUAL_END field is 24 bits in length and immediately precedes the RS field m each 
descriptor. The field is used by GISMO while the operation is in process to store the memory address 
of the data that is to be transferred to or from the memory buffer. When the operation is complete, 
the ACTUAL_END field contains the address of the next bit at which data would have been accessed. 

Each control is able to buffer (store) a certain amount of data to be transferred. The size of the buffer 
depends on the device. The amount of data that may be contained in the controls and the procedures 
that GISMO must follow in the execution of an operation are specified when the control is designed 
and do not change afterward. 
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I/O Chaining 

The I/O subsystem of the B 1000 system does not use queues for I/O operations. Using the facilities 
described in the preceding paragraphs, it connects all I/O descriptors that are directed to the same con- 
trol or group of controls connected by an exchange into a circular chain. This eliminates the need to 
direct an I/O COMPLETE interrupt to the MCP as long as the requestor, usually a user program, 
does not produce requests faster than they can be satisfied. In other words, if the I/O subsystem is 
completing operations before they are actually required by the user, the user never needs to wait for 
the completion of an I/O request, and the MCP never needs to suspend the program waiting for such 
a completion. 

Even when the user program is forced to wait for the completion of I/O requests, the amount of pro- 
cessing needed to suspend and then reinstate a program is minimized by the use of chaining. Processing 
is limited to that required for program execution; none is needed to tell the I/O subsystem what it 
should do next because that information is already contained in the I/O descriptor. 

For all devices except tape and disk, the MCP constructs a circular chain of descriptors in memory. 
GISMO executes the requested operations in turn as each descriptor is unlocked by the MCP. Upon 
encountering a locked descriptor, GISMO simply stops going through that chain until the descriptor 
is unlocked. This occurs when the user program requires a physical I/O operation or when the file 
is closed for any reason. If the program must wait on an operation, an I/O COMPLETE interrupt 
is requested through the use of the appropriate bit in the RS field, and the program is then suspended 
pending the occurrence of the interrupt. 

Disic I/O Chaining 

The disk I/O subsystem operates somewhat differently from the operation just described. Since each 
disk I/O descriptor contains a disk address field, it is not necessary for the operations to execute in 
any particular order. Various means are provided in the software to avoid contention problems. 
(Similar techniques are needed in I/O subsystems that utilize queueing instead of chaining.) 

All I/O descriptors for disk controls are connected in the same chain. If the system has more than 
one disk control, then each Channel Table entry points to the head of the chain. If GISMO encounters 
a descriptor that is not ready for execution or is already in process (RS field, bits and 1 not equal 
to 00), it does not stop but continues to the next descriptor in the chain. Also, if an exception condition 
occurs, GISMO does not stop as it does on other controls. Both of these actions are specified by the 
LINK_ON_EXCEPTION bit in the Channel Table. 

Since GISMO continues linking in both of the cases mentioned above, it must know when it has exam- 
ined all the descriptors in the chain. At that time it must stop to free the processor for other execution. 
To accomplish this, a special descriptor with the lO OP field set to @840000@ is used to mark the 
top of the chain. 

The PENDING bit in the Channel Table is set by GISMO when it receives a dispatch operation from 
the MCP. When GISMO hnks to the special descriptor denoting the top of the chain, and the PEND- 
ING bit is set, it does not stop but resets the PENDING bit and continues linking. If the PENDING 
bit is reset when GISMO links to the top of the chain, GISMO stops linking. 

This method assures proper functioning of dispatch operations that occur in a sequence different from 
that of the descriptor link fields. For example, if descriptors A, B, and C are present in the chain, 
and B is dispatched, GISMO links to and initiates B. If, during the time that B is in process, A is 
dispatched, GISMO links past C to find and initiate A. 
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Since all descriptors for all disk controls are maintained in the same chain, GISMO must be able to 
recognize descriptors that are addressed to controls different from the one it is handling. This is accom- 
plished using bits 20-23 of the RS field of the I/O descriptor. Upon encountering an unlocked I/O 
descriptor, GISMO compares this field to the channel it is executing upon. If the two are not equal, 
GISMO does not mark the descriptor in process but continues linking. 

Disk I/O Overlapped Seeks 

When an I/O operation is initiated on a moveable arm disk device with the arm positioned to a cylin- 
der different from the one specified in the descriptor, the arm must be moved to the proper cylinder. 
This operation is called a "seek." On the B 1000 system, all seek operations are implicit; there is no 
explicit seek operation in the hardware. The MCPs initiate disk I/O operations without regard for the 
current arm position. If arm movement is required, it is accomplished by GISMO, the control, and 
the device without the participation of the MCP, which never knows when a seek is required or is 
being performed. 

All seek operations are overlapped. This means that the arm of any given drive may be in motion si- 
multaneously with the arms of other drives. Also, the control may be performing data transfer or any 
other operation while the arms are in motion. This is accomplished by the control returning a result 
descriptor with RS bit 16 = to inform GISMO that some special action is necessary and that the 
result descriptor should not be stored. In this particular case, the control also informs GISMO that 
the selected drive is now seeking (RS bit 3 = 1). No further operations are initiated upon that drive 
until GISMO is informed by the hardware that the seek operation has completed. 

All disk pack controls except the DSC on the B 1990 notify GISMO that a seek operation has com- 
pleted by raising Service Request while in Status Count 1. GISMO again sends the descriptor to the 
control and this time, after any required latency period, data transfer occurs. 

Because the DSC has an I/O descriptor buffer for each disk unit, it does not interrupt GISMO when 
the seek operation completes. Instead, it retains control of the I/O descriptor until it is ready for data 
transfer to occur. 

Tape I/O Chaining 

The chaining of I/O descriptors for magnetic tape controls is perhaps the most complex of the three 
chaining operations. The complexity is caused by the fact that tape I/O descriptors directed to each 
separate tape unit must be executed in logical sequence, and there may be several such units attached 
to the same controls. It does not matter which unit GISMO addresses next, but the descriptor that 
is used to address the unit must be the next logical descriptor in the "subchain" for that unit. There- 
fore, it is necessary to break the channel chain into subchains (one subchain for each physical unit) 
and to implement a means of remembering the next logical descriptor that must be used within each 
subchain. 

Both of these requirements are satisfied by the LOCK descriptor. LOCK, a pseudo I/O operation, is 
handled completely by GISMO and causes no physical I/O operations. It also serves as a means of 
resolving contention problems between the MCPs and GISMO and between two or more tape controls 
that are attached to the same units by an exchange. LOCK operates as follows: 

When the system is Clear/Started, the MCP constructs a tape chain with one LOCK descriptor for 
each unit connected to the system. The ACTUAL__END field of a Lock descriptor is not used, and 
the LINK field contains the memory address of the next Lock descriptor. The BEGIN and END ad- 
dress fields of the Lock descriptor contain the address of the TEST.AND.WAIT I/O descriptor that 
the MCP uses to monitor the status of each unit. This is discussed in the following paragraph. 
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When a file is opened on a tape unit, the MCP locks the Lock descriptor by swapping @01@ into 
the first two bits of the result status field. The MCP next constructs a subchain for the unit. The sub- 
chain consists of one I/O descriptor for each buffer requested by the user. The BEGIN and END ad- 
dresses of the Lock descriptor are set to the memory address of the first I/O descriptor in the subchain 
and the TEST.AND.WAIT descriptor is removed from the subchain. The BEGIN address field is not 
altered until the file is closed. The END address is modified by GISMO each time it executes an 
operation in the subchain so that the next operation to be performed on the unit is remembered. 

The LINK fields in each I/O descriptor in the subchain will address the next physical descriptor in 
the subchain, as they do for all other controls. An exception to this is the last physical descriptor in 
the subchain. The LINK field of this descriptor contains the address of the Lock descriptor for that 
unit. This prevents one unit from monopolizing the entire control and assures that GISMO will 
periodically determine if there is anything to be done on the other units. 

The REF ADDR field of the Channel Table entry for a tape chain contains the address of the special 

descriptor with the lO OP field set to @840000@, which marks the top of the chain. GISMO, upon 
receiving a dispatch for a tape control, discards the Reference Address passed and starts at the address 

provided by the REF ADDR field. GISMO first attempts to lock the Lock descriptor by swapping 

@01@ into the first two bits of the RS field. If successful, it fetches the address in the END field 
of the Lock descriptor and proceeds to that address. If this descriptor is unlocked, it begins the 
operation specified. If not, it returns to the Lock descriptor and stores the address, which it previously 
fetched from the END address field back into the END address field. 

Assume now that the descriptor at the address fetched from the END field of the Lock descriptor was 
unlocked. GISMO begins this operation and, assuming that the operation cannot be completed without 
some intermediate Service Requests, returns to the Lock descriptor and continues linking through the 
chain. Eventually, the control will raise a Service Request and reference the initiated descriptor. Upon 
completion of that descriptor, GISMO stores a result and fetches the LINK field of the descriptor. 
It then proceeds to the new descriptor and again checks to see if it is locked. If it is, GISMO returns 
to the Lock descriptor for the unit and stores the new address in the END address field. The new 
descriptor now becomes the next logical descriptor to be executed on that unit. In this manner, GISMO 
effectively maintains a logical sequence of operations that are to be performed on any tape unit. 

There is no possibility of conflict for a unit between two or more controls connected by an exchange, 
since GISMO first attempts to lock the Lock descriptor before proceeding down a subchain. Similarly, 
the MCP must lock the subchain before altering any descriptor in the subchain. 
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APPENDIX G 
DISK ORGANIZATION 

This appendix, in eight parts, describes the following disk formats: 

1. Records at the beginning of system disks. 

2. Records at the beginning of user disks. 

3. Pack labels. 

4. Master and working available tables and temporary tables. 

5. Directories. 

6. File headers. 

7. File dictionaries. 

8. File Information Blocks. 

SYSTEM DISK FORMAT 

Table G-1 shows the formats of the records at the beginning of the system disk. 

Table G-1. System Disk Beginning Record Formats 



Description 

Pack label (HPT disks have no labels.) 

Disk sector relocation table 

Master available table 

CSV (Cold start variables) 

Filler (Was Log mix information (if LOG is set) 

prior to 12.0) 

Trace FPB 

Disk directory 

SYSTEM.PCU.AND.SERIAL.NUMBERS: 

Filler (Was the XM table.) 

Temporary table 

Working available table 





Pointed 


kddress 


to by 



1 

2-4 





CSV 


5-6 





7-19 


CSV 


20-31 


CSV 


32-47 


CSV 


48 





49-57 





58-63 


CSV 


64-73 


CSV 
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USER DISK FORMAT 

Table G-2 shows the formats of the records at the beginning of a user user disk. 



Table G-2. User Disk Beginning Record Formats 



Pointed 
Address to by Description 

Pack label 

1 Disk sector relocation table 

2-31 Pack label Master available table 

32-47 Pack label Disk directory 

48-57 Pack label Working available table 

58-62 Pack label Temporary table 
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PACK LABEL 

All disks except head-per-track subsystems are identified by a standard American National Standard 
Institute (ANSI) pack label. A pack label occupies sector 0, and is non-expandable. Sector contains 
pack identification information, sector 1 is the start of the sector relocation table. 

The following is a programmatic description of a pack label. 



CONSTANT PACK LABEL SIZE = l80;% BYTES. 
RECORD 
1 PACK LABEL DECLARATION CHARACTER (PACK 
02 PL VOLT CHARACTER (V 

02 PL~SERIAL NO CHARACTER 

02 PL"'ACCESS~CODE CHARACTER 

02 PL"ID ~ CHARACTER 

U3 PL NAME CHARACTER 

03 FllLER CHARACTER 

02 PL SYSTEM INTERCHANGE CHARACTER 






LABEL SIZE) 

■ % "VCLI" 
% SERIAL (CAN) 
% ACCESS CODE 
% PACK ID 



NUMBER 



02 PL CODE 
02 FllLER 
02 PL OWNER 
02 PL"TYPE " 



ID 



02 PL CONTINUE 
02 FITLER 
02 PL INT 
02 PL~V0L2 

02 pl~date initialized 
02 pl"init~system 
02 pl~disk~directory 
02 pl'mastir avail 
02 pl"disk available 
02 plIinteUrity 

02 pl error count 
02 pl~sectors xd 

02 PL"TEMP TAlLE 
02 PL~PCD ~ 
02 PL"ASSIGNED TO BPS 
02 PL~SP SEC FlAGJ 
02 FITLER 



CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 



10 

I 

% 
% 
% 
% 

'I! 



6) 
If' 



% SYSTEM INTERCHANGE/CODE 
00 - INTERCHANGE 
17 - B1700 INTERNAL 
35 - B3500 INTERNAL 
ETC, ETC, ETC 

% PACK CODE 00 - SCRATCH 



CHARACTER (1) 
CHARACTER (26) 
CHARACTER (1) 
CHARACTER (4) 
CHARACTER (5) 
CHARACTER (6) 
CHARACTER (8) 
CHARACTER (8) 
CHARACTER (8) 
CHARACTER (1) 

CHARACTER (6) 
CHARACTER 6) 
CHARACTER {8) 
CHARACTER (3) 
CHARACTER (6) 
CHARACTER (8) 
CHARACTER (23) 



% 
% 
% "C" 



"U" - USER PACK 
"S" ■= SYSTEM. PACK 

CONTINUATION FLAG 



% "V0L2" 

% INITIALIZING SYSTEM 

% DIRECTORY ADDRESS 

% MASTER AVAILABLE TABLE 

% WORKING AVAILABLE TABL 

% = NORMAL 

% 1 - RECOVERY REQUIRED 

% REMOVED SECTORS 

% TEMP TABLE LINK 

% LAST PORT, CHAN, DRIVE 

% BASE PACK SERIAL NUMBER 

% SPARE. SECTOR. TABLE FOR 225 
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DISK AVAILABLE TABLES 

In order to allocate disk storage, available disk space is described in the three tables described next. 
Master Available Table 

• Begins at disk sectors 2, 3, and 4. 

• Is expandable as needed. 

• Includes a list of disk segments not removed by the XD command or by disk initialization or 
by extensions to the relocate table (RLT). 

• Consists of one table for each user drive and one for each system drive. Each system drive table 
is physically located on the drive it describes. 

Working Available Table 

• Begins at disk sectors 64 through 73 (@40@ through @49@) on the system disk. 

• Begins at disk sectors 48 through 57 (@30@ through @39@) on the user disk. 

• Is expandable as needed. 

• Contains a list of available disk segments. 

• When a user disk is purged, the contents of the working available table are replaced by the con- 
tents of the master available table. 

• One table for each user drive and one for all system drives. The system drive table is on the 
first drive. 

Temporary Table 

• Begins at sectors 58 through 62 (@3A@ through @3E@). 

• Is expandable as needed. 

• Provides a list of temporarily-in-use disk segments. 

• At CLEAR/START time, all segments are returned to the working available table. 

• One table for each user drive and one for all system drives. The system drive table is on the 
first drive. 
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General Information 

The master available table and the working available table are always maintained in sorted (ascending 
AVL ADDRESS) order. When entries are inserted or deleted, the table is compressed or expanded. 

The temporary table is not maintained in sorted order and is not compressed and expanded. 

All three types of table are extended as necessary. 

All three tables have the following programmatic description. 



RECORD 

01 SLOT REC 


BIT(60) , 


% 


SLOT RECORD 


02 DADR 
03 PCU 
Ok PC 
Ok FILLER 
Ok EU 
03 DA 
02 LTH 
% 
RECORD 

01 AVL REC 
02 PTRS 
03 SUCC 
03 PRED 
03 SELF 
02 TEMP AVL TYPE 


BITpG), 

BIT(12), 

BIT{7), 

BOOLEAN, 

BIT(M. 

WORD, 

WORD; 


% 
% 
% 
% 
% 
% 
% 


DISK ADDRESS 

PORT, CHANNEL, & 
PORT £ CHANNEL 

UNIT 
ADDRESS 
LENGTH 


BIT(SEG SIZE), 
BlT(108), 
DISK ADDR, 
DISK~ADDR, 
DISK~ADDR, 
BIT (IT). 


% 
% 
% 
% 
% 


AVAILABLE RECORD 
POINTERS 

SUCCEEDING RECORD 
PRECEDING RECORD 
THIS RECORD 



UNIT 



% ?n1y used in temporary tables. If the temporary table 
% requires extension segments (I.e. above the preal located 
% 5 sectors), space for the extension segment is recorded in 
% the available table. During disk cleanup (at clear start 
% for the system disk, at pack ready time for user disks) 
% the temporary table extension segments are returned to 
% available table. Extension segments are flagged by @F@, 
% base segments are flagged by @0@. 

02 SLOTS BIT(1320), « SLOT RECORDS 

03 SLOT (22) SLOT REC, % 22 PER AVL REC 

02 FILLER B\JC5) ; % 
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DISK DIRECTORY 

The disk directory catalogs all files on disk. The directory is a two-level (master directory and secon- 
dary directory) structure. Each master directory entry contains a file name, a type, and either the ad- 
dress of the disk file header (DFH) for the file or the address of the secondary directory for all double- 
name files with that first name. The characteristics of the directories are described next. 

Master Directory 

• Begins at sectors 32 through 47 (@20@ through @2F@). 

• Is expandable as needed. 

• Each sector contains entries for 11 files. 

• For single-name files, name, DFH address, and type are listed. 

• For double-name file, the first name and the secondary directory address for all files with that 
first name are listed. 

• There is one directory for each user drive and one for all system drives. The system drive direc- 
tory is on the first drive. 

Secondary Directory 

• Allocated as needed. 

• Is expandable as needed. 

• Each sector contains entries for 11 files. 

• For double-name files, the second name, DFH address, and type are listed. The file name look- 
up algorithm hashes the first name into one of the 16 master dictionary disk sectors and then 
performs a sequential search. 

Both directories have the following programmatic description. 



01 DIRECTORY 


BITdiflfO) , 


02 DISK SUCCESSOR 


DISK ADDRESS, 


02 DISK~PREDECESSOR 


DISK ADDRESS, 


02 DISK~SELF 


DISK~ADDRESS, 


02 FILLlR 


BIT (12), 


02 DISK NAME 


CHARACTER (10) 


02 DISK~ADDRESS 


DISK ADDRESS 


02 DISK~FILE TYPE 


BITTO. 
BIT(1200); 


02 FILLlR 



% 

% 
% 



FORWARD 

BACKWARD 

THIS 

1ST ENTRY 



LINK 
LINK 
LINK 



10 



(VALUE IS 
MORE ENTRI 




ES 



OR 2) 
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DISK FILE HEADER 

The disk file header describes the physical attributes and contains pointers to each area of a disk file. 
The length of a DFH varies between one and three disk sectors, depending on the number of areas 
declared. A disk file header for a file with fixed record length has the following characteristics: 

• Allocated as needed. 

• Expandable from one to three sectors. 

• First sector contains physical attributes and addresses for areas 1 through 25 for fixed record 

length files. 

• First sector contains physical attributes and addresses for areas 1 through 23 for variable record 
length files. 



• 



Second sector, if any, contains addresses for areas 26 through 65 for fixed record length files. 

Second sector, if any, contains addresses for areas 24 through 63 for variable record length files. 

• Third sector, if any, contains addresses for areas 66 through 105 for fixed record length files. 

A programmatic description follows. 

RECORD 

01 DFH RECORD BIT(580) , 

02 DFH AREA ADDR OFFSET BIT(l6), 

%SFFSET INTC the DFH (IN BITS) FOR THE FIRST AREA ADDRESS 
02 DFH FILE TYPE BIT (8) , 

%TYPE UF FILE DESCRIBED BY THIS HEADER 
02 DFH SELF BIT (36) , 

%niSK ADDRESS OF THIS HEADER 

02 dfh no users bit(&) , 

%liiuml5er of users who have this file opened 
02 dfh users open out bitw, 

%tiumber"of u^ers who have this file opened i/o or output 
02 dfh open type bit (a) , 

%h0w this file was opened 
3 dfh open lockout boolean, 

3 dfh~open"lock boolean. 

3 dfh open output boolean, 

3 dfh open input boolean, 

02 dfh file type 8 bit(4) , 

%Fre-9.o fiIe types 

02 DFH PERMANENT BIT (it) , 

%n0W PERMANENT THIS FILE IS. THE VALUES ARE — 

% = TEMPORARY - WILL BE REMOVED NEXT CLEAR/START 

% 1 = PERMANENT - NORMAL FILES CONTAIN THIS VALUE 

% 2-D NOT USED 

% E = IAD FILE - CANNOT BE MOVED BY SQUASH 

% F = SYSTEM FILE - CANNOT REMOVE, CHANGE OR SQUASH 

02 DFH JOB WAITING ON CLOSE BOOLEAN, 

%50MECNE ATTEHPTID TO OPEN THIS FILE BUT COULDN'T BECAUSE 
%IT IS CURRENTLY OPENED LOCK OR THE REQUESTOR WANTS TO OPEN 
%IT LOCK AND ITS IN USE. TELLS CLOSE TO CAUSE ANY JOBS 
%WAITING NO FILE WHEN THIS FILE IS CLOSED. 

02 DFH NEWFILE BOOLEAN, 

%THIS file IS NOT IN THE DIRECTORY YET 
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02 FILLER BIT (6), 

02 DFH HDR SIZE BIT(l6) , 

%TOTAr SIZE OF THIS HEADER (IN BITS) 
02 DFH NO USERS LOCK BIT (4), 

%RUMlER 0F~USERS WHO HAVE THIS FILE OPENED WITH LOCK 
02 DFH RECORD SIZE BIT(20) , 

%5lZE OF THE RECORDS (IN BITS) 
02 DFH_FILE LEVEL BIT (4) , 

% = H.O AND EARLIER 

% 1 = 9.0 
02 DFH RCDS BLOCK BIT (20) , 

%WUMBER OF RECORDS PER BLOCK 
02 DFH BLOCKS AREA BIT(2if), 

%(TUMBER UF BLOCKS PER AREA 
02 DFH SEGS AREA BIT (24) , 

%TJUMBER OF SEGMENTS OR SECTORS PER AREA 
02 DFH AREAS RQST BIT(12) , 

%HAXIMUH NUMBER OF AREAS ALLOWED IN THIS FILE 
02 DFH_AREA_CTR BIT (12) , 

%CURRENT HIGH AREA NUMBER ALLOCATED 
02 DFH EOF POINTER BIT(24), 

%HlGHrST RECORD NUMBER WRITTEN IN THIS FILE 
02 DFH AUDITED BOOLEAN. 

? DO NOT REINSTATE USER UNTIL 1/0 IS COMPLETE 
02 DFH PROTECTION ATTR BIT(2), 

f HOW BADLY DOES THE USER WISH TO SAVE THIS FILE IN THE 
% OFF CHANCE OF A CLEAR/START WHILE OPEN ? 
% «= TEMPORARY 
% 1 = ABNORMALSAVE 
% 2 - SAVE 

% 3 = PROTECTED 
02 FILLER BOOLEAN, 

02 DFH BPS NO BIT (20) , 

%^ERI^L NUMBER OF THE BASE PACK TO WHICH THIS MULT I -PACK 

%FILE BELONGS 
02 FILLER BIT(27) . 

02 DFH MPF BOOLEAN, 

%THIS IS A MULT I -PACK FILE 
02 DFH UPDATE DATE BIT(l6), 

%JULIAN UATE of THE LAST TIME THIS FILE WAS CLOSED AFTER 

%HAVING BEEN WRITTEN ON. ALSO DATE OF LAST NAME CHANGE. 

%FOR CODE FILES, ITS THE DATE OF THE LAST MODIFY. 
02 FILLER BIT(4) , 

02 DFH CREATE TIME BIT(20), 

%TlME THl FILE WAS OPENED OUTPUT NEW. 
02 FILLER BIT (32) . 

02 DFH SAVE FACTOR BIT(12), 

%RUMBER of days TO SAVE THIS FILE. NO SIGNIFICANCE. 
02 DFH CREATION DATE BIT(l6), 

%JUL1AN DATE OF WHEN THIS FILE WAS OPENED OUTPUT NEW. 
02 DFH" ACCESS DATE BIT(l6), 

%JuLiAN Hate of when this file was last opened, for codefiles, 

%DATE LAST EXECUTED OR MODIFIED. 

02 FILLER BIT(6l) , 

02 DFH UPDATF._VERSION BOOLEAN, 

%nMS USE ONLY 

02 FILLER BIT(2) , 

02 DFH VERSION BIT(36) , 

%TlME AND DATE OF THE LAST CLOSE. I/S AND DMS ONLY. 

02 DFH PROTECTION BIT (2) , 

%~0 = PUBLIC FILE 

% 1 = PRIVATE FILE 
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02 DFH_PROTECTION 10 

% = ACCESS MAY BE 
% 1 = ACCESS MAY BE 



I/O 

INPUT ONLY 
% 2 = ACCESS MAY BE OUTPUT ONLY 



B1T(2), 



02 DFH USERS FROZEN 



BIT(8), 



% NUMBER OF USERS FOR WHO THIS HEADER CANNOT BE ROLLED OUT 



02 FILLER 

02 DFH MINRECSiZE 

%HlNIMUM NUMBER OF BITS 
02 DFH MAXRECSIZE 

%RAXIMUM NUMBER OF BITS 



BiT(8). 

BIT (20) , 
IN EACH LOGICAL RECORD 

BIT (20) ; 
IN EACH LOGICAL RECORD 



RECORD 
01 



AN AREA ADDRESS 

02 DFH Unit 

03 UFH_PC 

Oit DFH PORT 
Ok DFH CHAN 
03 DFH SER no FLAG 
03 DFH~EU " " 
02 DFH ADUR 



BIT(36), 
BIT(12), 
BIT(7). 
BIT 3), 

bitW, 

BOOLEAN, 
BITW. 
BIT(2it) ; 



RECORD 

01 AREA ADDRS BIT(3780) , 

02 AREA ADDR (105) AN AREA ADDRESS, 

02 FIRST_AREA REMAPS AREA_ADDR"AN_AREA_ADDRESS; 



1152055 



G-9 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Disk Organization 



B 1000 FILE TYPES 



DEFINE 

DATA TYPE F I LE (X) AS 

#((X = OR X = 9 OR X = 11) OR. (X >- 13. AND X <= .15) 

I ) #» 



OR (X >= 17 AND X <-= 22) OR 



CODE TYPE FILE(X) 

#(X -~8 OR (X >« 



AS 
110 AND X <= 



(X >= 60 AND X <- 109); 
139))#. 



MICROCODE TYPE FILE(X) AS 

#{X = 7 OR~(X >- HO AND X <- l69))#f 






CONSTANT 

% % 

% VALID FILE TYPES : DFH FILE TYPE, FPB FILE TYPE % 

% r r z r % 

% % 

4^ ^^ ^) ^^ ^Q ^1 ^^ ^^ ^^ ^g ^Q ^^ ^Q ^^ ^1 ^1 ^^ ^Q ^g ^^ ^^ '^ ^g ^^ ^^ ^Q ^^ ^^ ^P ^y ^^ 4^ ^1 ^Q ^^ ^^ ^^ d^ ^Q «^ ^^ 4^ j^ ^1 ^^ 4^ ^^ ^1^ ^^ ^^ ^g ^^ ^Q ^P 4^ ^^ ^^ ^^ ^^ ^1 ^^ ^^ ^Q rf^ ^1^ ^^ ^^ ^^ ^^ 

% % 

% SBP CSG % 

% DESCRIPTION CODE ABVR CODE % 

















-* 

% 


% 


SYSTEM FILES 












% 


% 














% 




LOG FILE 




001, 


% 


"LOG " 


000 


% 




DIRECTORY FILE 




002, 


% 


"DIR " 


301 


% 




PSR DECK ~ 
PRT FILE 




003. 

ooii. 


% 
% 


"DECK" 
"PRT " 


306 
30i» 


% 
% 




PCH~FILE 




005, 


% 


"PCH " 


305 


% 




DUMP TYPE FILE 




006, 


% 


"DUMP" 


000 


% 




INACTIVE rOG FILE 




010, 


% 


"TLOG" 


000 


% 




INTRIN FTLE ~ 




012, 


% 


"INSC" 


119 


% 




usercoUe file 




016, 


% 


"USER" 


000 


% 




MCP TEMPORARY FILE 




02^, 
02li, 


% 


"TEMP" 


000 


% 




JOBLOG_FILE ~ 


= 


% 


"JLOG" 


000 


% 


% 














% 


% 


025 < > 059 RESERVED 


FOR 


ADDITIONAL 


SYSTEM FILES 




% 


% 














% 


i- 














-4 


*- 














-♦ 


0. 














% 


% 


DATA FILES 












% 


% 














% 




UNSPECIFIED DATA FILE 


s 


000, 


% 


"DATA" 


000 


% 




DATA FILE 


B 


009, 


% 


"DATA" 


000 


% 




VARIABLE LENGTH FILE 


s 


Oil, 


% 


"VAR " 


000 


% 




DMS DATA~FILE " 


S 


013. 


% 


"DMS " 


000 


% 




DMS"D 1 CTTONARY 


- 


OH, 


% 


"DMSD" 


000 


% 
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% 

% 

% 

%- 

% 

% 

% 



DMS AUDIT FILE 

RE LIT I VE ~ 

INDEX SEQGLOBAL FILE 

INDEX"SEQ_ DATA SlT FILE 

INDEX~SEQ_ INDEX FllE 

INDEXlD TiG FILF 

INDEXED'DATl FILE 

SDLSYMBUL 

COBOL68SYMBOL 

RPGSYMBOL 

NDLSYMBOL 

FORTRANSYMBOL 

MILSYMBOL 

BASICSYMBOL 

UPLSYMBOL 

C0B0L7^SYMB0L 

FORTRAN77SYMBOL 

I BASICSYMBOL 

DASDLSYMBOL 

PASCALSYMBOL 

SDL2SYMB0L 

NON NATIVE DATA 

IBA^IC INTERNAL 

FORTRAffy? UNFORMATTED 

COBDMS Ll^ 

RPGDMS"LIB 

NETWORK INFORMATION 

NDL LIBRARY 

PASCAL INTERCHANGE DATA 

PASCAL MODULE DATA" 

SORTSYHBOL 

SEQDATA 

JOBSYMBOL 

UPL2SYMB0L 

WFL DATA DECK 



015 

016 
019 
020 
021 
022 
060 
061 
062 
063 
061* 
065 
066 
067 
066 
069 
070 

071 
072 

073 
07^ 
075 
076 

078 
079 
080 
081 
082 
083 
O8II 
085 
086 
087 



% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 



"AUDT' 

"REL ' 

"IS.G' 

"IS.D' 

"IS. I' 

"TAGS' 

"INXD' 

"SDL ' 

"C068' 

"RPG 

"NDL 

"FOR 

"MIL 

"BAS 

"UPL 

"C07^' 

"F77 ' 

"I BAS' 

"DASD' 

"PASC 

"SDL2' 

"IDTA' 

"IBSU' 

"F77U' 

"CDMS' 

"RDMS' 

"NIF ' 

"NDLB' 

"PIDF' 

"PSMD' 

"SRTS' 

"SEQD' 

"JOBS' 

"UPL2' 

"DATA' 



086 <- 



-> 109 



RESERVED FOR ADDITIONAL DATA FILES 



000 % 

000 % 

000 % 

000 % 

000 % 

000 % 

000 % 

000 % 

OOif % 

031 I 

012 % 

010 % 

000 % 

002 % 

000 % 

035 I 

033 % 

000 % 

005 % 

030 % 

000 % 

000 % 

000 % 

000 % 

000 * 

000 % 

000 % 

000 % 

000 % 

000 % 

oik % 

020 % 

026 % 

000 
UNK 

% 

% 

% 

% 



CODE 



FILES 



CODE FILE 

SDLCUDE 

COBOL68CODE 

RPGCODE 

NDLCODE 

FORTRANCODE 

MILCODE 

BASICCODE 

UPLCODE 

C0B0L7'»C0DE 

F0RTRAN77C0DE 

I BASICCODE 

PASCALCODE 

SDL2C0DE 

SMCPCODE 

MCSCODE 

NON NATIVECODE 

B505CODE 

IBMUOOCODE 



008, 
110, 

in, 

112, 
113. 
1H, 
115. 
116, 
117. 
118, 
119. 
120, 
121. 
122, 
123. 
12i». 
125, 
126, 
127. 



% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 
% 



"CODE" 
"SDLO" 
"C68O" 
"RPGO" 
"NDLO" 
"FORO" 
"MILO" 
"BASO" 
"UPLO" 
"C740" 
"F770" 
"IBSO" 
"PSCO" 
"SD20" 
"SMCP" 
"MCSO" 
"ICDE" 
"B50 " 
"IBMO" 



% 

% 

% 

100 % 

100 % 

103 % 

162 % 

109 % 

107 % 

100 % 

102 % 

100 % 

165 % 

163 % 

100 % 

161 % 

100 % 

120 % 

100 % 

100 % 

100 % 

100 % 
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SORTCODE 




128, 


% 


"SRTO" 


164 


% 




SDL2UNB0UNDC0DE 


s 


129, 


X 


"SD2U" 


100 


% 




JOBCODE 


B 


130, 


% 


"JOBO' 


115 


% 


% 
% 
% 


UPL2C0DE 


= 


131. 


% 


"UP2C' 


100 




131 < > 139 


RESERVED FOR 


ADDITIONAL 


CODE FILES 


% 

X 

-X 


« — 

% 

% 


1 C R C D E F 


1 L E S 










% 
X 
X 




INTERPRETER FILE 


m 


00?. 


% 


"INTP' 


130 


X 




SDL INTERPRETER 


= 


litO, 


% 


"SDLI' 


130 


X 




COBOL68 INTERPRETER 


B 


141. 


% 


"C68l' 


122 


X 




RPG INTERPRETER 


E= 


U2. 


% 


"RPGI' 


125 


X 




NDLMICROCODE 


S 


Iit3. 
lU. 


% 


"NDLI' 


130 


X 




FORTRAN INTERPRETER 


K 


% 


"FORI' 


123 


X 




BASICINTERPRETER 


B 


U5. 


% 


"BASr 


130 


X 




UPL INTERPRETER 


s 


li»6. 


% 


"UPLI' 


130 


X 




COBOL?'* INTERPRETER 


e 


148, 


% 


"C?4l' 


130 


X 




FORTRAN?? INTERPRETER 


% 


"F??l' 


130 


X 




IBASICINTERPRETER 


= 


149, 


% 


"IBSr 


130 


X 




PASCAL INTERPRETER 


= 


150, 


% 


"pscr 


130 


X 




SDL2INTERPRETER 


b: 


151. 


% 


"SD2I' 


130 


X 




MICROMCP 


= 


152, 


% 


"HMCP' 


130 


X 






«= 


153. 
154, 


% 


"GSMO' 


130 


X 




SYSTEM INITIALIZER 


m 


% 


"iNir 


130 


X 




B500 INTERPRETER 


m 


155. 


% 


"B5i ' 


130 


X 




IBMIifOO INTERPRETER 


E 


156; 


% 


"IBMI' 


130 


X 


% 
% 
% 


% END OF FILE 


TYPE DEFINES 


********************************* 

* 


157 < > 169 


RESERVED FOR 


ADDITIONAL 


MICRO CODE FILES 


X 

X 

-3: 


*-- 
% 
% R 


OOM TO GRO 


W 










X 
X 
X 


% 


i?o < > 199 


FUTURES 










X 


% 


200 < > 219 


RESERVED FOR D 1 SKMAP 






X 


% 
% 


220 <-— — > 255 


FUTURES 










X 
X 



xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
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FILE DICTIONARY 

Every program that has any files declared for input of output has a file dictionary. The dictionary 
is a set of system descriptors. There is one system descriptor for each file declared, plus one for the 
trace file. (Appendix E, Memory Management, includes a programmatic description of a system de- 
scriptor.) The trace file is used by debug interpreters to write trace information. The RAID system 
file equates the trace file to a queue file that has been opened by RAID. 

At the time a system memory dump is executed, each file in the dictionary is either open or closed. 
If the MEDIA field FIB (file information block) dictionary contains MEDIA, the File Information 
Block (FIB) is in memory at the address in the ADDRESS field, and the file is open if 
FIB.OPEN_FLAG is TRUE. If the MEDIA field is blank and the address field contains zeros, the 
file is closed. If the MEDIA field is blank and the address field is non-zero, the file information block 
and any file buffers are rolled out to disk, and the file is open if FIB.OPEN_FLAG is TRUE. 

FILE INFORMATION BLOCK (FIB) 

As each file is opened by the user program, a File Information Block (FIB) is created in memory by 
the MCP. The FIB contains all information necessary for the MCP to perform I/O operations on the 
file. Much of the information in the FIB is taken directly from the file declaration in the user program. 
Other information is inserted by the MCP, based upon the characteristics of the peripheral device as- 
signed to the file. 

I/O descriptors and buffer memory areas are allocated and initialized when the file is opened. There 
is only one memory link for each file that is open. Buffer areas and descriptors are not normally shared 
between files, although exceptions to this rule include DMS, Data Comm, and Indexed files. 

FIB size depends upon the type of device assigned to the file. Due to the amount of information that 
must be maintained, a disk file FIB is much larger than a card punch file FIB. 

A complete programmatic description of a FIB follows. 



CONSTANT 

FIB SIZE 
FIB'COMMON SIZE 
FIB~SIZE EXTRA BNALIO 
FIB~SIZE QUEUE" 
FIB SIZE PORT 
SUBPORT TfRRAY SIZE = 
FIB SIZl NDL 

fib size ufw 

fib s i ze~d i agnostic = 

fib~uniqDe size 

fib~size disk 

fib size~basic 

F I B~S I ZE"TA!PE 
FIB"SIZE~PRINTER 
FIB"SIZE~MICR 
MAX~MAX 3fUBiP0RTS 
FIB ORGIN I ZAT I ON 



101*8, 

268, 

= it02. 

k3i. « INCLUDES 

451, % INCLUDES 

77, 

10i*8. 
kk2, 

24717. 
= FIB SIZE, 

- 681*7 

- 796, 
= FIB SIZE TAPE, 

- lOltB, 

= 255, 
RELATIVE ■= 1, 



ELEMENT 
SUBFILE 



% QUEUE PART 



FIB_ORGANIZATION_INDEX_SEQ - 2; 
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% 
RECORD FIB SUBPORT 

CHANGlEVENT 

STATE 

QIN PTR 

QOUT PTR 

ERROl 

MAX REC SIZE 
% ~ ~ 



ATTR RECORD 



BOOirAN, 
BIT (4). 
ADDRESS, 
ADDRESS, 
BIT (8), 
BIT (16) ; 



% 



USERS 
USERS 



INPUT 
OUTPUT 



SUBPORT 
SUBPORT 



ADDRESS. 
ADDRESS. 



RECORD 1 FIB RECORD BIT (FIB COMMON SIZE + FIB_UNIQUE SIZE), 
2 COMMON ElT(FIB COMMON ^IZE), ? COMMON TO ALL DEVICES 
3 BOOLEANS BIT(5H), % COMMON TO ALL DEVICES 
k OPEN FLAG BOOLEAN, 

% 1 - FILE HAS BEEN OPENED. NOT YET CLOSED, 
k CLOSING BOOLEAN. % 

%1= FILE IS BEING CLOSED, BUT HAS TO WAIT 
% FOR I/O TO COMPLETE. 
h MYUSE BIT(2) , 

% PECULIAR 2 BIT FIELD USED BY NDL 
.5 OUTPUT BOOLE AN, % 

%1 = FILE IS OPENED FOR OUTPUT, 
% MAY BE NEW OR OLD FILE. 
5 INPUT BOOLEAN, %DONT CHANGE POSN FIB. OUTPUT. 
%1 = FILE IS AN OLD FILE OPENED FOR 
% INPUT OR OUTPUT OR BOTH (RANDOM OR SEQ) 
k STOP 10 BOOLEAN,* 

%1 = I/O STOPPED, DUE TO I/O ERROR OR EOF. 
4 ENHANCED 10 PERMITTED BOOLEAN, % 

~ ~%0 - SUPPRESS ENHANCED I/O. NOT USED YET. 
k VARIABLE BOOLEAN, % 

%1 = FILE HAS VARIABLE LENGTH RECORDS, 
% HENCE FIB. RECORDS. BLOCK WILL BE SET TO 1 
% FIB. ACCESS MUST NOT BE 1 (RANDOM I/O), 
% FILE POSITIONING IS NOT ALLOWED YET. 
k COBOL FILEF BOOLEAN, 

%1 = FILE IS TO BE HANDLED AS COBOL FILE. 
% HENCE HANG PROGRAM IF OPEN IS INVOKED 
% WHILE FILE IS- ALREADY OPEN, 
% CLOSE IS INVOKED WHILE FILE IS NOT YET 
% OPEN OR ALREADY CLOSED, OR EOF HIT 
% TW ICE. 
k LABELED BOOLEAN,* 

%1 = FILE IS LABELED (MEANINGLESS FOR DISKS) 
k PSEUDO BOOLEAN,* 

%1 = FILE 
h BACKUP BOOLEAN,* 

%1 = FILE IS BACKUP 
% TAPE OR DISK. 
k DMS BOOLEAN,* 

*1 = FILE IS DATA MANAGEMENT. 
k DEVICE FLAGS BIT(lM ,% 

*ACTUAL DEVICE TYPE. VERY USEFUL. 
REVERSE BOOLEAN-,* 
CRD96 BOOLEAN,* 
DATA RCDR BOOLEAN, 
DISK DEVICE BOOLEAN, 

*1 « FILE IS ACTUALLY ON DISK, 
* PROBABLY PSEUDO. READER OR BACKUP OR 
% "FILE EQUATED" BEFORE OPEN TIME AS DISK. 
5 DISK PACK DEVICE BOOLEAN, 
5 TAPE DEVIUE BOOLEAN,* 
5 REM lACKUP BOOLEAN,* 
5 PUNtH BOOLEAN.* 



S A PSEUDO READER ON DISK. 



PRINTER OR PUNCH ON 



5 
5 
5 
5 
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5 mcp close reel boolean, % 

5 eofIreporTed boolean,* 

%1 = eof hit once. if fib. cobol, then 
% next hit on eof will hang program. 

5 printer device boolean, 

5 trace boolean,* this is a trace.fib 

5 linage code boolean, % invoke line counter code 

5 printer check boolean,* 
k 10 seqwrTte req boolean,* 

k I0"ERRUR INFU BIT(7) , 

5 To ERRUR SEEN SMCP BOOLEAN,* 
5 IO~ERROR"THIS~COMQ BOOLEAN,* 
5 IOlERR0R~0N RlAD BOOLEAN, 
5 10 ERR0R~TYPE BIT(M ,* 

* 1 = EOF OR EOP 
% 2 = PARITY 

* 3 = INCOMPLETE I/O 

* li = EOF ON PAPER TAPE READERS 

* 5 = EOV ON LDDMP MULTIFILE SEARCH 
k TEMPORARY FREEZE BOOLEAN, * LOCK FIB IN MEMORY 
k DUMMY_FILr BOOLEAN, 

% NO LOGICAL I/O TO BE DONE 
k CANNOT CLOSE LOCK BOOLEAN,* 

? OPENED ON-BEHALF-OF BUT WITH ERROR; 
U AUDITED BOOLEAN,* 

* DO NOT REINSTATE USER UNTIL I/O IS COMPLETE 
i* MPF BOOLEAN,* MULTIPACK DISK FILES. 

k CLOSED HERE BOOLEAN, * MPF WAITING DISK, 
it EOT BOOLEAN,* END OF TAPE REEL. 

%THIS BIT ALSO MEANS END OF BACKUP IF FIB DISK 
i4 EMULATOR TAPE BOOLEAN,* 

k CYL ALLOr BOOLEAN,* USER WANTS CYLNDR BOUNDS 

h WAITNEWAREA BOOLEAN,* 

* I/O STOPPED WAITING FOR NEW AREA ON MULTI 
% PACK FILE (INPUT OR OUTPUT) OR ELSE NON 

* MULTIPACK OUTPUT FILE NEEDS DISK SPACE. 
k NEWAREA BOOLEAN,* 

* NEW AREA HAS BEEN CREATED ON OLD OR NEW 

* DISK FILE, HENCE AT CLOSE OR DS, AREAS IN 
% TEMPORARY TABLE MUST BE REMOVED, OR ELSE 

* NEXT CLEAR/START WILL CLOBBER DISK, 
if SPECIAL_EU BOOLEAN,* 

* EU NO SPECIFIED BY USER FOR HPT ONLY. 
k OPEN_LOCK BOOLEAN,* 

If MCPINTERNAL BOOLEAN,* "PARAMETERS" FILE FOR LO 

* LOAD. DUMP USE ONLY. 

if NEWFILE BOOLEAN,* OUTPUT NEW, F I B. I NPUT-O. 

if LABEL IN_PROCESS BOOLEAN, *USED IN PARTICULAR FOR 

*D. RECORDER OPEN LABEL, 
if PRINTER FILE BOOLEAN, *FILE IS PRINTER HARDWARE 
if FILE WRITTEN ON BOOLEAN, *DISK FILE UPDATED 
if PROTlCT I ON ATTR B I T (2) , 
~ % = TEMPORARY 

* 1 = ABNORMALSAVE 

* 2 - SAVE 

* 3 = PROTECTED 

if OPTIONAL FILE BOOLEAN, 

if OPEN LOCKOUT BOOLEAN, 

if DIAGROSTIC FILE BOOLEAN, 

~% INDICATES THIS IS A DIAGNOSTIC FILE 
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It BNA FILE BOOLEAN, 

% HAVE ONLY LOGICAL, NO PHYSICAL, FILE. 

% ALSO MEANS THAT PORT STATE VARIABLES (RECORD AT 

% END OF FIB) LIVE AT END UF F I B EXCEPT FOR 

% DEVICE - PORT FILE. PORT STATE VARIABLES ARE 

% USED ONLY IN INA LOGICAL~l/0 ArROSS NETWORK, 

% DEVICES SUCH AS DISK, TAPE, CARD, PRINTER. 
3 ORGANIZATION BIT(i»), 

% IDENTIFIES THE TYPE OF FIB BEING USED 

% - ALL FILES SUPPORTED PRIOR TO 9-0 

% 1 - RELATIVE FILE 

% 2 - INDEXED/SEQUENTIAL FILE 

3 HDWR BIT (6),% 

% FOR MPF, IT PERTAINS TO 

% THE HARDWARE TYPE OF THE BASE PACK. 

% NOTHING PREVENTS US MIXING DEVICES FOR 

% MULTIPACK FILES. 
3 VERSION BIT{8),% 

%FOR FUTURE USE, IN CASE OF INCOMPATIBLE 

% FIB STRUCTURES. RIGHT NOW IT IS 1. 
3 REAL SIZE BIT(16) ,% 

%REAL LENGTH OF FIB, IN BITS. 

% SET UP BY OPEN IN "NO.F I LE.SPACE". 
3 ENHANCED 10 STATUS BIT (8),% 

~ ~ %FOR ENHANCED I/O TO SAY: 

% I'VE DONE SO MUCH SO FAR, YOU S.MCP 

% CONTINUE WITH IT." 
3 FILE NUMBER BIT (8) ,% 

%■= CT. OBJECT, - ENTRY NUMBER IN FIB.DICT. 
3 RS BIT(2it) ,% 

%ADDRESS OF L IMIT. REGISTER OF RUN. STRUCTURE 

% ONLY ONE RUN STRUCTURE ALLOWED PER FIB. 
3 ERR REPORT FLAGS BIT (24), 
h ERR PRESINT BOOLEAN, 

%ERROR OCCURRED DURING POCKET SELECT 
k FILLER BIT(IO) , 
k WHO FOUND ERR BOOLEAN, 

~ % 0=MMCP FOUND THE ERROR 

% 1=INTERPRETER FOUND THE ERROR 
U INTERP ERROR BIT (8), 

% SAME AS RS_ITYPE CAT RS_INMBR 
if MMCP ERROR BIT (4), 

% ERROR FOUND BY MMCP AS FOLLOWS: 

% 0= INVALID COMMUNICATE FROM USE ROUTINE 

% (FATAL) 

% 1-ILLEGAL POCKET SELECT (FATAL) 

% 2-JAM (NON-FATAL) 

% 3-MISSORT (NON-FATAL) 

% U-NOT READY (NON-FATAL) 
3 TRANSLATE TABLE BIT(24), 

It dmsglobSls bit (24) , 

*ADDR OF SOFT TRANSLATE TABLE IF PRESENT 
3 ERRORS BIT(16). 

« NO OF RETRIES FOR THIS FILE 
3 LIO FILE STATUS B1T(24) , 

~ " % CHANGED ON EVERY LIO. 
3 NEXT PORT ADDRESS, % NEXT PORT FIB ADDRESS. 

3 BACK""PORT ADDRESS, % BACK PORT FIB ADDRESS. 

%%%%% END OF COMMON PORTION %%%%%%%%%%%%%%%%%%%%%%%% 
UNIQUE BIT(FIB UN I QUE_S IZE) , 
3 FILLER BIT(3r, 
3 RETRY COUNT BIT(5) ,% 

%USED BY 10. ERROR TO COUNT RETRIES. 
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3 UNIT BIT(12),% 

%DEVICE'S PCU. FOR MPF WE NEED ALSO 
% FIB. DISK. UNIT FOR CURRENT PACK. 
k CHANNEL BIT(7),% 

%BOTH PORT AND CHANNEL. POOR NOMENCLATURE. 
k FILLER BOOLEAN.% 
it UNIT NO BIT(4),« 
3 I0AT_AUDR BIT(2i+),% ADDRESS OF I OAT ("UNIT" TABLE) 

% QUEUE-FILES USE DIFFERENT FIB HENCEFORTH 
3 MINRECSIZE BITdb) , 

^MINIMUM RECORD SIZE IN BITS 
3 MAXRECSIZE BIT(l6) , 

%MAXIMUM RECORD SIZE IN BITS 
3 RECORD DESC BIT{it8) ,% 

%A DESCRIPTOR OF THE CURRENT RECORD 
% (THE ONE TO BE PROCESSED, NOT THE ONE 
% JUST PROCESSED). LOGICAL I/O ENTITY, 
if FILLER BIT(8) ,% 
k RECORD SIZE BIT(l6) ,% 

% CONSTANT UNLESS 
% VARIABLE LENGTH RECORDS. 
5 ALPHA_SIZE BIT(13) ,% 

%T0 BE USED IF RECORDS ARE CHARACTER. TYPE, 
if RECORD ADDR BIT(2if) ,% 
% 
3 CURRENT BIT(2if) ,% 
if DESCRIPTOf^_A BIT (24) , 

%ADDRESS OF CURRENT I/O DESCRIPTOR, HENCE 
% INDIRECTLYT THE CURRENT BUFFER. 
% LOGICAL I/O ENTITY. 
3 RECORDS BLOCK BIT (20),% 

% =1 IF VARIABLE LENGTH 
% RECORDS. CONSTANT VALUE. 
3 BUFFER BIT(20) ,% 

%REMAINING SPACE IN BUFFER, 
% INCLUDING THE CURRENT RECORD DESCRIBED 
% BY FIB. CURRENT, IN BITS. 
% LOGICAL I/O ENTITY, 
if BITS_LEFT IN BUFFER BIT(20), 

5 FOR DHS AUDIT, SIMILAR TO REGULAR MEANING 
3 BUFFER_EMPTY BIT(2if),% 

%FOR INPUT FILES ONLY. A PHYSICAL I/O 
% ENTITY. IF PHYSICAL I/O STOPPED (E.G., 
% WAITING FOR INPUT MPF PACK, OR EOF) THIS 
% WILL POINT TO THE OLDEST 10 DESCRIPTOR 
% WHOSE BUFFER IS UNFILLED. LOGICAL I/O 
% IS ALLOWED TO CATCH UP TILL FIB. BUFFER. 
% EMPTY = FIB. CURRENT, 
if BUFFER NEXT_AVAILABLE BIT(2if), 

% FOR DMS AUDIT, CONTAINS THE ABSOLUTE ADDRESS OF 
% THE NEXT FREE POSITION IN THE BUFFER. 

3 BLOCK COUNT BIT(2if) ,% 

% PREVIOUSLY A PHYSICAL 

% ENTITY FOR DISK FILES, BUT SINCE 5.1 

% A LOGICAL I/O ENTITY. FOR INPUT FILES IT 

% IS BUMPED ONLY WHEN THE FIRST RECORD HAS 

% BEEN TRANSFERRED TO THE USER, HENCE 

% PROVING THE BLOCK TO BE NON-EMPTY 

3 BLOCK SIZE BIT(20) ,% 

% CONSTANT. 

3 RECORD_COUNT BIT(2if),% 

% NUMBER OF RECORDS PROCESSED SO FAR 
% EXCLUDING THE CURRENT RECORD. 
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3 SEGS AREA BIT(2l»),%N0. OF SEGMENTS PER AREA 
3 EOF PTR BIT(2if), 

%FOR OLD FILES, IT IS THE NUMBER OF ACTUAL 
% DATA RECORDS TO BE COMPARED WITH FIB. 
% RECORD. COUNT. IT IS THE ONLY WAY TO 
% CATCH EOF FOR VAR. LENGTH RECORDS CASE. 
3 CHANNEL INFO BIT(2i») ,% 

%ADDRESS OF CHANNEL TABLE. 
3 CLOSE TYPE BIT (36) ,% 

%36 BITS WITH SAME STRUCTURE AS CT ADVERB AND 
% CT 1 IN CLOSE. BITS ARE SET ON BY 
% CLOSE, IF SOME OTHER BITS ARE ON. 
3 ACCESS BITW ,% 

%T00 TROUBLESOME TO SAY "IF FIB. DISK THEN " 
% EVERYTIME WE TEST IT, SO WE FORCE IT ON 
% ALL PERIPHERALS 
% SERIAL 
% 1 RANDOM 

I 2 SEQUENTIAL. 10 

% 5 EMULATOR. TYPE 
% 6 DELAYED. RANDOM 
% 7 EXTENDED. SEQUENTIAL. 10 
% 8 DYNAMIC 

% FIB. INPUT AND FIB. OUTPUT MUST BE SET 
% TO ONE IF FIB. ACCESS <> 
3 KEY BIT(2i»),% 

% USED BY DISK AND TAPE FILES FOR LOGICAL 
% RECORD NUMBER. REPLACING F I B. RECORD. COUNT 
% IN THE OLD DAYS, LOGICAL I/O ENTITY. 
3 USE AREA BIT (48) ,% 

%USED BY DISK FILES. 
k SPACE CTR BIT{8),% COUNTER FOR SKIPPING 

% BLANK LINES ON PRINT. 
i» PAGE SIZE BIT(8) .^LOGICAL PAGE SIZE 

%(TEMP. PAGE. SIZE + TEMP.TOP.MARG IN + 
%TEMP. BOTTOM. MRGN) 
h UPPER MARGIN BIT (8) .^ABSOLUTE LINE # A LINE 

%0F PRINT MAY START. 
k FOOTING BIT(8),%ABS0LUTE LINE # WHERE 

%EOP IS TO BE REPORTED. 
k LOWER MARGIN BIT (8) .^ABSOLUTE LINE # TO STOP 

%PRINTING ON CURRENT PAGE. 
k LINAGE COUNTER BIT (8) ,%KEEPS TRACK OF THE LINE 
%# FOR EACH PAGE. 
3 USE ROUTINE BIT(32),% USED BY MICR. 
~ % 
4 TEMP PAGE SIZE BIT (8) ,%TOTAL # OF LINES WRITING 

~ %IS PERMITTED. (BODY) . 
k TEMP UPPER MARGIN BIT (8) ,%TOTAL LINES IN THE TOP 

~ %MARGIN. 
k TEMP FOOTING BIT(8),%LINE # WITHIN THE BODY 

%WHERE EOP IS REPORTED 
it TEMP LOWER MARGIN BIT (8) ,%PRINTER FIB ENDS HERE. 
~ %MICR FIB ENDS HERE. 
%TOTAL # OF LINES IN THE 
%BOTTOM MARGIN. 
3 LAST OP BIT(4),%LI0 PREVIOUS OP CODE. 

3 LAST'SPACING BIT(4),%LI0 PREVIOUS SPACING 
3 CURRENT OP BIT(4),%LI0 CURRENT OP CODE. 
3 FIRST WllTE BACKUP BOOLEAN, %FOR MMCP 
3 FILLER ~ BIT(l) , 

3 COUNT CARDS BIT{1) , 

3 COUNT~LINES BIT(l) , 
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3 LIO CURRENT STATUS BIT (3), 

k LTD OVERFLOW BOOLEAN, %SPACE PAST BOTTOM MARGN 
it LIO_EOP BOOLEAN, %SPACE INTO FOOTING. 

k LIO WRITE PENDING BOOLEAN, %POSITION BEFORE WRITE. 

3 FILLER ■" BOOLEAN, 

3 PRINTER_TYPE BIT(2) , 

% 00 it5O-7O0 LINE PER MINUTE PRINTER. 
% 01 1100 LINE PER MINUTE PRINTER. 
% 10 NOT USED. 
% 11 1500 LINE PER MINUTE PRINTER. 

3 DISK_ADDRESS BIT (36) ,% 

% DISK ADDRESS OF BLOCK LAST RELEASED 
% (FOR OUTPUT FILES) OR LATELY READ- 1 NT 
i> DISK PCU BIT(12) ,% 
5 DllK PC BIT(7) , 

5 SER No FLAG BOOLEAN, 
5 DISK EU BIT(it) , 

i» DISK SU BIT(2it) , 

3 HEADER" BIT(2li) ,% 

% OFFSET IN DFH.DER OF DISK FILE HEADER 
%MAY BE SHRUNK TO 12 BITS IN FUTURE. 

3 AREAS BIT (8) ,% 

% IF FIB. OUTPUT THEN MAXIMUM POSSIBLE AREAS 
% REQUESTED BY USER, ULSE ACTUAL NUMBER 
% OF AREAS CONTAINING DATA. 

3 AREA_NUMBER BIT (8) ,% 

^PHYSICAL I/O ENTITY. AREA NUMBER (COUNTING 
% FROM ZERO) WHERE LATEST I/O OCCURRED. 
% WARNING: VALUE SHOULD BE <105 
% EXCEPT 255. WHICH MEANS -1. 

3 BLOCKS_AREA BIT(2lt) ,% 

% SINCE RELEASE 5-1 WILL BE 
% ABLE TO HANDLE PARTIAL BLOCK AT THE END 
% OF EACH AREA. PREVIOUS RELEASES SIMPLY 
% IGNORE THEM. 

3 BPA COUNT BIT(24) ,% 

^PHYSICAL I/O ENTITY. 

% VALUE=1+"FIB. BLOCKS. AREA" - NUMBER OF 

% DATA BLOCKS IN CURRENT AREA PRIOR TO AND 

% EXCLUDING THE CURRENT BLOCK. IN SERIAL 

% I/O, WHEN THE SECOND LAST BLOCK IS 

% RELEASED BY RELEASE .BUFFER, FIB. BPA. CT 

% FOR OUTPUT FILES WILL BE REDUCED FROM 3 

% TO 2 AND FOR INPUT FILES FROM 2 TO 1 . 

% AWKWARD, BUT PRECISE. A CALL FOR 

% NEW. AREA IS TRIGGERED WHEN RELEASE .BUFFR 

% FINDS THAT FIB. BPA. CT IS TO BE REDUCED 

%FROM 1 TO 0. NEW. AREA WILL RESET IT TO 

% TO (FIB.S.A+FIB.S.B-1)/FIB.S.B-FIB.B.A 

3 SEGS_BLOCK BIT (12) ,% 

% A CONSTANT. PREVIOUSLY 
% CALLED FIB.SEGS. 

3 RECORDS AREA BIT (24) ,% 

% MAY NOT NECESSARILY BE 

% A MULTIPLE OF F I B. RECORDS. BLOCK. 

% MEANINGLESS FOR VARIABLE LENGTH RECORDS. 

3 EU_DRIVE BIT (it) ,% 

%NOT USED YET. 

3 PSEUDO_RDR BIT (24) ,% 

%ADDRESS OF PSEUDO READER TABLE. 

3 MAX RECORDS BIT (24) ,% 

3 PARTIAL BLOCK SIZE BIT (2it) ,%=F I B.S .A MOD.FIB.S.B 

3 FILLER " BTT(2) ,% 
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3 RELATIVE RECORD INDEX BIT(20), »„»»^.»„ 

%n END OF STANDARD FIB %%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
NDL PART REMAPS UNIQUE BIT (F I B_S I ZE_NDL-F I B_COMMON_SI ZE) , 
3 NlfT_FIB BIT (24) , 

3 BCK_FIB BIT (2k) , 

3 QUE_NR BIT (24) , 

3 MCS PRTCP BIT (2) , 

4 MUS PRTCP OUTPUT BOOLEAN, 

4 MCS"PRTCP INPUT BOOLEAN, 

RMT KlY BOOLEAN, 

HDR~ BOOLEAN, 

SIMPLE HEADERS BOOLEAN, 



3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 



BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 



(2), 
(85. 
(10), 



IT ( 



(10), 
10), 



(10), 
24), 
24), 



RSDNT 

MCS FL 

LGL STN_NR 

RND_RBN 

CUR MAX STN 

REAl MAX STN 

INPUT COUNT 

OUTPUT COUNT 

AUD REr 

MSG ID VALID 

MSG ID 

CRElfTED 

JN TBL ADDR 

LSTJ_LI5T 
3 QUE NAME 

4 QUE NAME 

4 FILlER 
3 C74_ESI 
3 C74 EMI 
3 C74_rGI 
3 LGL STN TBL BIT(ll) , 

4 LGL„STN BIT (10) , 



BOOLEAN, 
BOOLEAN, 

BIT(20) ,% MSG. TIME, E.G. 
BOOLEAN, 
WORD, 

ADDRESS, % POINTS TO C74.LSN.LI ST. 
CHARACTER (48) , 
1ST 3 CHARACTER (3) , 
~ CHARACTER (45) , 
CHARACTER (1) , 
CHARACTER (1), 



CHARACTER (1) , 



% EG I NOT IMPLEMENTED. 



4 STN DTCHD BOOLEAN, 

%%%% END NDL FIB %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
BIT (FIB SIZE_UFW-FIB_COMMON SIZE), 
BOOLEAN, 
BOOLEAN, 
BOOLEAN, 
BOOLEAN, 
BOOLEAN, 
BOOLEAN, 

BOOLEAN, 



UFW PART REMAPS UNIQUE 
3 Urw FIRST_TIME_THRU 
UFW~LAST_OP READ 
UFW DUPLICATE 
UFW MATCH FOUND 
UFWUPDATI FLAG 
UFW~F I RST_FASS 
FILLER 



UFW WRITE ERR REPORTED BOOLEAN, 
UFW~ACCESl MOUE BIT(4) , 
UFW~J0B_NUHBER BIT(24), 
UFW"REC0RD ADDRESS BIT (24), 
UFW~KEY pointer ADDRESS, 
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UFW COMMUNICATE WORKSPACE BIT(6l6), 

k UTVI BINARY SElRCH ARGUEMENTS BIT (208), 



UFW INTERFACE PiDS 
5 UFWiFIRST 2k ~ 
5 UFW DESCR" 

6 UFWTYPE 

6 UFW LENGTH 

6 UFWiADDRESS 
5 UFW R REMAPS UFW DESCR 

6 UFW SECOND 2k ~ 

6 FILlER 

5 FILLER 

k UFW SAVE STATE AREA 



ADDRESS, 
BIT 8), 
BIT (24) 



3 UFW GlOBAL'POINTlR 
3 UFWCURRENT STRUCTURE 
3 UFWHEADER " 

%%% END UFW FJB %%t 
QUEUE_PART remaps UNIQUE BIT( 

FIB SIZE QUEUE + 1023 * 21* 

FILLER ~ ~ 

Q_FAMILY SIZE 

Q_READ 1(5 DESC 

Q_WRITr lU DESC 

Q_FAMILy ~ 

q_record count 

Q_PTRS1 ~ 

k QD PTR(102it) 



BIT (96). 

^'■^ ?ri' 
BIT(it8) , 

BIT (08) , 

BIT(l6) , 

BIT(2lt) , 

BIT (48) , 

BIT 2A) , 

BIT (24),, 

BIT (24) , 

BIT(312), 



3 DT0_PCU 

3 DI0_I0AT_ADDR 

3 DIO CONTROLS 



3 DIO PC (4) 



% 

% 
% 



FIB COMMON SIZE) , 
BIT (44),% Q-DISK ITOODIES" 
BIT (24) ,% QFF # MEMBERS 
BIT (24) ,% REF-ADDR OR ZERO 
BIT(24),% REF-ADDR OR ZERO 
BIT( 1) A 1 -> QFF FIB 
BIT(24),% # OF LOGICAL l/O-S 
BIT(1024 * 24) .%FIB.Q. FAMILY. SIZE 
BIT(24), 
Q PTRS2 REMAPS Q_PTRS1 BIT (1024 * 24), 
4 Q^PTR BIT (24), 

4 FILLER BIT (1023 * 24). 

n% END NDL FIB %%%%%%!%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
D I DEPART REMAPS UNIQUE BIT (FIB SIZE DIAGNOSTIC - FIB COMMON SIZE), 
^ BIT (12), - - - _ /. 

% PORT CHANNEL AND UNIT OF PRIMARY UNIT 
ADDRESS, 
I OAT ENTRY FOR PRIMARY UNIT 

BIT (3). 
NUMBER OF CONTROLS ASSIGNED TO THIS FILE 
(MAXIMUM OF 4) 
BIT (7), 
% PORT AND CHANNEL OF EACH CONTROL 
3 DIO_CONTROL OPENED BOOLEAN, 

% ALL UNITS SHARING THE CONTROL HAVE BEEN OPENED 
3 DIO SHARED_ACCESS BOOLEAN, 

% OTHER USERS MAY ACCESS THE UNIT(S) 
3 DIO_NAMED_FILE BOOLEAN, 

% CORRESPONDS TO PHYSICAL DISK FILE 

ADDRESS, 
% ADDRESS OF FIRST DESCRIPTOR FOR THIS FILE 

BIT (24). 
% OFFSET IN DFH.DIR OF DISK FILE HEADER 
DIO_STARTING ADDR BIT (24), 

~ % MINIMUM SECTOR THAT MAY BE ACCESSED 
DIO_STOPPING ADDR BIT (24), 

~ % MAXIMUM SECTOR THAT MAY BE ACCESSED 
DIO_OPS_WAITING BIT (4), 

% NUMBER OF OPS MARKED AS WAITING THAT MUST COME 
% COMPLETE BEFORE JOB CAN BE REINSTATED 

BIT (4). 
% NUMBER OF CHANNELS ASSIGNED FOR A DATACOM DEVICE 
%%%% END DIO FIB %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 



3 DIO_CHAIN 
3 DIO_HEADER 



3 DIO CHANNELS 
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BIT (FIB SIZE PORT + 

1) * SUBPURT array size - FIB COMMON SIZE), 

(8), %"o-relT index to FTON-ZERU SUBP. 

(8), % subport# for broadcast_write. 

(8), % how many user wanted. 

_.. (8), % last one read from. 

% for automatic write back to the same one. 

ROUNDROBIN bit (8), % used for "READ ANY/NEXT". 

% TO SERVICE PORTS FAIRLY. WITHOUT STARVATION OF SOME BECAUSE 
% OF OTHERS THAT ALWAYS HAVE DATA IN THEM. 



2 PORT PART REMAPS UNIQUE 
"(MAX MAX SUBPORTS - 

3 wait_suIporT bit 
3 broadcast sp bit 

3 MAX SUBPOlTS BIT 
3 LASTSUBPORT BIT 



inputcount 
outputcount 
port keys 
portIchangeevenT 
3 event count 

3 EVENT_SUBP_INDEX 



% FOR ALL SUBPORTS. 
% FOR ALL SUBPORTS. 
% ALL I/O VERBS HAVE KEYS. 



WORD, 
WORD, 
BOOLEAN, 
BOOLEAN, 
BIT (8), 

,, >,„„. ..,^.„ BIT (8), - 

%~GET 7fTTR(CHANGEDSUBFILE) , GET ATTR (F I LESTATl) 
3 SUBP (MAX_RAX_.SUBP0RTS) p^^^-^'j'^''§^J^^g|^||J§%§|%%%%%%%^%%%%%^%%|%% 



% NUM SUBPORTS WITH CAUSED CHG EV 
% USED BY CAUSE SUBP._STATE_CHG, 



% 
% 
CONSTANT 

SPS CLOSED 

SPS AWAITINGHOST 

SPS OPEN PENDING 

SPS OPENlD 

SPS~SHUTDOWN_l N_PROCESS 

SPS"BLOCKED 

SPS~DEACTIVATION PENDING 

SPS"RMT DEACTIVATED 



% 



DEACT RMT CLOSE_V 
DEACT UNREACHABLE V 
DEACT_TIMEOUT_V 

SPS CHNG MASK 



VALUES 
@00@ 
@01@ 
@02@ 
@03@ 

|05§ 
@07@ 
@08@ 

@01@ 
@02@ 
@03@ 



@800008@ 



FOR SUBPORT STATES: 
% REFER TO'HOST SERVICES USER 
% INTERFACE SPEC 2373-2571 
% SAME AS OFFERED 



RECORD 1 PORT STATE VARIABLES BIT (F I B_S I ZE EXTRA_BNAL 
3 PORT STSTE VARS BIT (2007 
5~ACTUAr MAX MSG„SIZE WORD 



10) 



5 STATE 

5 SEG STATE 

5 RETTIINED 

5 IMPLIED 

5 TAG 

5 FRAMES I ZE 

5 B1000 

5 FILLER 
I0_SUBP0RT_STATE 
IN Q 
OUT Q 

actDal buffer size 

AREAS TfLLOCATlD MASK 



WORD % PROTOCOL STATE 

WORD 

BOOLEAN % CLOSED W/ RETAIN. 

BOOLEAN 

CHARACTER (8) 

WORD 

BOOLEAN %CO0P HOST IS BIOOO 

BIT(37) 
BIT W 
ADDRESS 
ADDRESS 
WORD 
BIT(105) 
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APPENDIX H 
TAPE ORGANIZATION 

This appendix is in three parts. The first, Tape Labels, describes tape label formats acceptable to 
B 1000 systems. The second, Tape Format, describes the format of the information written on a mag- 
netic tape. The third. Tape Status, describes the state of a tape after each of the various operations 
is performed. 

TAPE LABELS 

The MCP includes the capability to create and recognize two different forms of magnetic tape labels. 
The standard label format for the B 1000 system conforms to that specified in the publication entitled 
American National Standard Magnetic Tape Labels for Information Exchange, 1969, published by the 
American National Standards Institute (ANSI). These labels are commonly known as ANSI, Version 
1 labels. 

It should be noted that the standard label format for the system means that program file declaration 
requests for standard labels result in the writing of ANSI labels when the file is assigned to magnetic 
tape and opened output. 

As of MCPII level 11.0.27, ANSI Version 3 tape labels also can be recognized. 

ANSI labels as implemented on the B 1000 system contain several deviations from ANSI standards. 
The deviations insure compatibility with the B 5000/B 6000/B 7000 series systems. The most notewor- 
thy deviation is the recording mode of the label itself. Unless the American Standard Code for Infor- 
mation Interchange (ASCII) is specifically requested by the user with the SN system command, the la- 
bel is automatically written in EBCDIC. 

ANSI Labels, though they are written when the file is opened output, are actually created on all mag- 
netic tapes prior to that time. The SN (Serial Number) system command enables creation of the initial 
ANSI label on all tapes. The SN system command is described in section 5 of the B 1000 Systems Sys- 
tem Software Operation Guide, Volume 1. 
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ANSI Tape Label Format 

The ANSI tape label format as implemented consists of three physical blocks of tape, followed by a 
tape mark. The first of the three blocks, the Volume Header, has the following programmatic descrip- 
tion. 



RECORD 

01 VOL HEADER_RECORD 

02 FILLER 

02 VOL ID 

02 ACCESSIBILITY 

02 RFS 
03 MP ID 



03 SYS SYMBOL 
03 TAPr_TYPE 



03 FILLER 
02 OWNER ID 
02 FILLER 
02 VERSION 



CHARACTER (80) 
CHARACTER ( k) 
CHARACTER ( 6) 
CHARACTER ( 1) 
CHARACTER (26) 
CHARACTER (17) 



CHARACTER ( 
CHARACTERS 



2) 
1) 



CHARACTER ( 6 
CHARACTER (14 
CHARACTER (28) 
CHARACTER ( 1) 






"0" IF 
"XO" FOR 
"BACKUP" 
"17" 



NO MULT 

17 
IF 



PLE FILE 
IF SCRATCH 
BACKUP 



SCRATCH 
USER 
BACKUP 
L I BRARY 



% 1 FOR THIS STANDARD 



The second of the three physical blocks is Header One. The same format is also used for end of file 
and end of volume. 



RECORD 

01 HEADERl 



RECORD 



02 FILLER 

02 FILE„ID 

02 FILE SET ID 

02 FILE~SECTl0N_N0 

02 FILE SEQ_N0 

02 GENERATION NO 

02 GENERATION_VERSION 

02 CREATION_DATE 

02 EXPIRATION DATE 

02 ACCESSIBILITY 

02 BLOCK COUNT 

02 SYSTEH_C0DE 

02 FILLER 



NO 



CHARACTER (80) , 
CHARACTER ( h) , 
CHARACTER (17) 
CHARACTER 6) 
CHARACTERS 4) 
CHARACTER ( 4) 
CHARACTER ( k) 
CHARACTER ( 2) 
CHARACTER ( 6) 
CHARACTER ( 6) 
CHARACTER ( 
CHARACTER ( 
CHARACTER (1 
CHARACTERS 



% HDRl, EOVl, EOFl 



1), 

6) ,%HDR1="000000", 

3)' o. 
7) 3 %RFS 



EOV, EOF = REA 



H-2 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Tape Organization 



The third physical block, Header Two, is also used at end of file and end of volume. 



RECORD 

01 HEADER2 RECORD 

02 FILLER 

02 RECORD_FORMAT 

02 BLOCK LENGTH 
02 RECORTJ LENGTH 
02 RESV SYSTEM USE 

03 DENSITY " 

03 SENTINAL 

03 PARITY 

03 EXT FORM 



03 FILLER 
02 FILLER 



CHARACTER (80) 
CHARACTER ( k) 
CHARACTER ( 1) 

CHARACTER ( 5) 



CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 



5 

1 
1 
1 
1 



% HDR2, E0V2, E0F2 






FIXED, D 
SPANNED, 



VARIABLE, 
" UNDEFINED 



,%0 - 800, 1 - 556, 



%0 > 
% 



CHARACTER (31) , 
3); 



% 
% 
% 



ALPHA (EVEN) 
= UNSPECIFIED 
= BINARY 
- ASCI I 
= BCL 
" EBCDIC 



2 = 200, 3-1600 
1 " BINARY (ODD) 



CHARACTER (28) ; % RFS 



The MCP writes labels in ANSI format whenever a file is opened output, and the LABEL.TYPE field 
in the FPB is set to zero. To write the old Burroughs format labels, the LABEL.TYPE in each file 
in the pertinent programs must be modified. This may be accomplished in any of the following four 
ways: (1) by recompilation, (2) by the use of a File Attribute communicate operation within the pro- 
gram, (3) by use of the MODIFY program control instruction (see section 4 of the B 1000 Systems 
System Software Operation Guide. Volume I), or (4) by the use of a FILE card when the program 
is executed. Presently valid values for the LABEL.TYPE field are: 

= ANSI 

1 = Unlabelled 

2 = Burroughs 

The MCP writes tapemarks and ending labels on any output labeled tape that is not at beginning of 
tape (BOT) when a Clear/Start is done. This allows the user to read that tape and recover the data. 
There is one restriction. If the tape is to be read in reverse, the user must specify blocking information. 

ANSI labels are also written as the standard label on 7-track tape. When this is done, the labels are 
written with translation to Burroughs Coded Language (BCL). Burroughs labels, when written to 7- 
track tape, are written in odd parity, with the EBCDIC/BCL translator enabled. 
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TAPE FORMAT 

The format of the information that can be written on a magnetic tape is described in the following 
paragraphs. Both multifile tapes and multitape files are considered. A multifile tape is a labeled tape 
which contains zero or more data files. A multitape file is a data file which fills one or more tape 
reels and continues on another tape reel. 

MULTIFILE TAPE 

A multifile tape includes a label, optionally followed by data files, and a tape mark. The label contains 
a volume header and a header for the first data file, if any. A data file consists of a header, the data 
itself, and an end of file. The first data file uses the header in the label. Each of the additional data 
files has its own header. The last data file is followed by a tape mark, which causes the tape to be 
terminated with a double tape mark. 

The label is an ANSI standard label with certain deviations required for compatibility with other Bur- 
roughs computer systems. The label consists of a volume header (VOLl) and a header. 

The header consists of a header 1 record (HDRl), a header 2 record (HDR2), and a tape mark (TM). 

The end of file consists of a tape mark, an end of file 1 record (EOFl), an end of file 2 record (EOF2), 
and a tape mark. 

MULTITAPE FILE 

A multitape file has the first part of a data file on one or more tape reels and the remaining part 
of the data file on a continuation tape reel. 

The initial tape reel concludes with data and the end of tape photoreflective marker, followed by an 
end of volume and a tape mark. Valid data can be written beyond the end of tape mark. The tape 
is terminated with a double tape mark. 

TAPE STATUS 

The state of a magnetic tape after various operations are performed is described next. In the descrip- 
tions, which are numbered, a scratch ANSI label consists of a volume header block, a header 1 block, 
a header 2 block, and a tape mark. 

1. Tape is initiaUzed with the SN/SNL input message. 

The tape is: 

• Rewound. 

• Written with a scratch ANSI label. 

• Rewound. 

• Readied or locked depending on whether SN or SNL was used. 
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The tape contents and Read/Write head position are as follows: 

* BOT VOLl HDRl HDR2 TM 

* = R/W head position 

2. Tape is opened for output for File 1. 
The tape is: 

• Rewound. 

• Spaced over the volume 1 record. 

• Rewritten for the header 1 record. 

• Rewritten for the header 2 record. 

• Rewritten for the tape mark. 

• Accessible only to the program that opened it. 

The tape contents and FLead/Write head position are as follows: 
BOT VOLl HDRl HDR2 TM * 

* = R/W head position 

3. Tape data is written for File 1. 

The tape contents and Read/Write head position are as follows: 
BOT VOLl HDRl HDR2 TM Data * 

* = R/W head position 

4. Tape is closed with no rewind. 

The tape contents and Read/Write head position are as follows: 
BOT VOLl HDRl HDR2 TM Data TM EOFl EOF2 TM TM * 

* = Read/Write head position 

5. Tape is opened for output for File 2. 

The tape contents and Read/ Write head position are as follows: 

BOT VOLl HDRl HDR2 TM Data TM EOFl EOF2 TM . . . . 

.... HDRl HDR2 TM * 

* = Read/Write head position 

1152055 H-5 



B 1000 Systems Memory Dump Analysis 

Functional Description Manual 

Tape Organization 



6. Tape data is written for File 2. 

The tape contents and Read/ Write head position are as follows: 

BOT VOLl HDRl HDR2 TM Data TM EOFl EOF2 TM . . . . 

.... HDRl HDR2 TM Data * 

* = Read/Write head position 

7. Data is written beyond EOF of the initial reel. 

The tape contents and Read/Write head position are as follows: 

BOT VOLl HDRl HDR2 TM Data TM EOFl EOF2 TM . . . . 
.... HDRl HDR2 TM Data EOT Data TM EOVl EOV2 TM * 

* = Read/Write head position 

8. Tape is positioned to read or write the continuation reel. 
The tape contents and Read/Write head position are as follows: 

BOT VOLl HDRl HDR2 TM * 

* = Read/Write head position 

9. Tape continues to be written for File 2. 

The tape contents and Read/Write head position are as follows: 
BOT VOLl HDRl HDR2 TM Data * 

* = Read/Write head position 

10. Tape is closed with release for File 2. 
The tape contents and Read/Write head position are as follows: 
BOT VOLl HDRl HDR2 TM Data TM EOFl EOF2 TM TM * 

* = Read/Write head position 
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RP(3 PROGRAM MEMORY DUMP 



The following paragraphs describe how to obtain an RPG program memory dump and how to read 
the useful information contained in it. Example programs are included to illustrate the INVALID SUB- 
SCRIPT and STACK OVERFLOW program aborts. 

HOW TO OBTAIN AN RPG PROGRAM MEMORY DUMP 

The RPG program memory dump is generated by entering either of the following system commands: 

< j ob-number > DM 

<job-number>DP 

The DM system command causes a memory dump to be created and allows the program to continue 
executing. 

The DP system command causes a memory dump to be created and discontinues the program. 

The memory dump created by entry of the DM or DP system commands is a file with the name 
DUMPFILE/< integer >, where < integer > is a system-generated number. After the file is created, a 
human-readable listing of the memory-dump file may be obtained by entry of the following system 
command: 

PM < integer >; 

The PM system command causes the DUMP/ANALZER program to analyze the memory-dump file 
and produce the hsting. 

RPG DATA AREA DUMP INFORMATION 

The RPG DATA AREA DUMP portion of the analyzed dump file begins with the following heading: 

*** RPG DATA AREA DUMP *** 
Next S-op at S= 11,D= 74 

NEXT INSTRUCTION POINTER Information 

The heading for the RPG data area dump portion of the memory dump includes a NEXT INSTRUC- 
TION POINTER: 

Next S-op at S= 11,D= 74 

The dump also shows this pointer in the information that precedes the 
*** FULL DUMP ANALYSIS *** portion of the memory dump printout, following the job status in- 
formation. Following are two examples, the first from a STACK OVERFLOW dump and the second 
from an INVALID SUBSCRIPT dump: 

INVALID SUBSCRIPT: S=ll, D = 74 (@00B@,@0004A@); DS or DP 

STACK OVERFLOW: S=12. D = 31 (@00C@,@O001F@); DS or DP 
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This information identifies the next instruction to be performed. (S means segment, D means offset.) 

The LOGIC and XMAP compiler-directing options must be specified in order to locate which RPG 
source record is being processed. The XMAP information associates the segment-displacement informa- 
tion with a paragraph name, and the LOGIC information associates the paragraph name with the RPG 
source record. 

CONTAINER SIZES Information 

The CONTAINER SIZES information has the following format. 

ft** CONTAINER SIZES *** 

23 :COP TABLE ENTRY 

n :DATA DISPLACEMENT: 

8 :DATA LENGTH: 

6 :COP INDEX: 

12 : BRANCH DISPLACEMENT 

INDICATORS SET Information 

The INDICATORS SET information shows which indicators in the RPG program were ON when the 
memory dump was generated. The format of the INDICATORS SET information follows. 

*** INDICATORS SET *** 
01 
10 
20 
LO 



1-2 



B 1000 Systems Memory Dump Analysis 
Functional Description Manual 
RPG Program Memory Dump 



CURRENT OPERAND (COP) TABLE Information 

The CURRENT OPERAND (COP) TABLE information lists the table address, COP index, data type, 
address (segment, displacement), digit length, and the data for each field name used in the RPG pro- 
gram. Note that some field names are used internally by the RPG cycle and are not available for use 
by the RPG programmer. The following is the format of the COP table information. 



*** CURRENT OPERAND (COP) TABLE *** 


TABLE 


COP 


DATA 


ADDRESS DIGIT 




ADDRESS 


INDEX 


TYPE 


(SEG.DISP) LENGTH 


DATA 


@0000i»0§ 


1 


UN 


0,128 


3 


001 


@000057@ 


2 


UN 


0,131 


3 


000 


§00006E§ 


I 


UN 


0,13^ 


3 


001 


@000085@ 


UN 


0,137 


2 


01 


@00009C§ 


5 


UN 


0,139 
0,140 


1 





@0000B3@ 


6 


UN 


1 





@0000CA§ 


I 


UA 


0,141 


30 


7?7????7}??? 


@0000E1§ 


UN 


0,30 


2 


00 


§0000 F8@ 


9 


UN 


0,41 


2 


00 


§0001 0F@ 


10 


UN 


0,321 


3 


000 


§0001 2 6§ 


11 


UN 


0,324 


2 


00 


§00013D§ 


12 


UN 


0,326 


2 


00 


§00015't§ 


]l 


UN 


0,328 


8 


00000000 


§0001 6 B§ 


UN 


S:lf 


8 


00000000 


§000182§ 


15 


UN 


6 


000000 


§000199§ 


16 


UA 


0,344 1 


180 


9JJJJJ 


§0001B0§ 


\l 


UN 


0.524 


3 


001 


§oooiC7§ 


UA 


0,527 264 


5EEEEEE 












22222C33333D44444E55555 


§0001DE§ 


19 


UN 


0,791 


3 


Oil 


§0001F5§ 


20 


UN 


0,794 


3 


000 


§00020C@ 


21 


SN 


0.797 


1 


+0 


§0002 2 3§ 


22 


SN 


0,799 


4 


+0000 


§0002 3 A§ 


11 


SN 


0,804 


6 


+000000 


§00025 1§ 


SN 


0,811 


6 


SUBSCRIPTED — 1 FACTOR 












(TABLE BOUND = 28) 












FACTOR 1 = 7 










?} 


+111110 










2 


+222220 










?: 


+444440 










l5)_ 


+555550 


§00027F§ 


26 


UN 


0,846 


4 


0005 


§000296§ 


11 


SN 


0,850 


6 


+000000 


§0002AD§ 


UN 


0.857 


4 


0000 


§0002Cit§ 


29 


UN 


0,861 


4 


0000 


§0002DB@ 


30 


UA 


0,865 1 
0,1045 


80 


9JJJJJ 


§0002 F2§ 


31 


SN 


1 


+9 


§000309§ 


32 


UA 


0,1047 


12 


JJJJJ 
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SUBROUTINE STACK Information 

The SUBROUTINE STACK information lists the current nesting levels of the subroutine stack. This 
information is useful whenever a STACK OVERFLOW abort occurs in the RPG program. In general, 
increasing the value of the STACK compiler-directing option solves the STACK OVERFLOW program 
abort. 

The following is an example of the SUBROUTINE STACK information when no subroutines have 
been entered. 



§0013AC§ 
@0013AC@ 
*** NO ENTRIES 



SUBROUTINE STACK *** 
: STACK BASE 
: STACK TOP 
ON 'SUBROUTINE STACK 



AAA 



ANALYZING AN INVALID SUBSCRIPT PROGRAM ABORT 

The example source program in figure I-l and the MAP information generated in figure 1-2 show a 
method of associating field names with COP index entries. The subscript field name in the source pro- 
gram is IX and the array name is ARY. The MAP information associates IX with COP index 31 and 
ARY with COP index 32. The DATA column in the CURRENT OPERAND (COP) TABLE presented 
earlier shows that the COP index 31 has a value of -1-9. Since the number of entries for ARY is 5, 
an attempt to reference an index value of 9 causes an INVALID SUBSCRIPT program abort. 



00 TOO 
00110 
00120 
00130 
OOlIio 
00150 
00200H 



NAMES 

XREF 

MAP 

PARMAP 

LOGIC 

XMAP 



00300F I N 
OOiioOFLINE 

00500 E 

00600 1 I N 
00700 1 
00800 1 
00900 1 

OlOOOC 

onooc 

01200C 

013000LINE 
014000 
015000 
016000 
* 1- 



IPE 1800 90 



132 
ARY 



DISK 
PRINTER 

5 6 2 



NS 01 



01 



— A 2 *- 



MOVE ARDATA 

SETON 

SETOF 



RECORD 
ARY 

IX X 
-3 *— ■ 



1 
1 
2 

ARY, IX 



90 RECORD 
10IX 
7 ARDATA 



102030 
30 



90 
100 
110 



-5 ft 6—-* 7- 



Figure I-l. Source Program with Compiler-Directing Options 
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CODE SPACE 



CODE SEG 





SIZE - 


179 


BYTES 






CODE SEG 


1 


SIZE - 


115 


BYTES 






CODE SEG 


2 


SIZE - 


i*i 


BYTES 






CODE SEG 


I 


SIZE - 


k\ 


BYTES 






CODE SEG 


SIZE - 


25 


BYTES 






CODE SEG 


5 


SIZE - 


16 


BYTES 






CODE SEG 


6 


SIZE - 


13 


BYTES 






CODE SEG 


I 


SIZE - 


12 


BYTES 






CODE SEG 


SIZE - 





BYTES 






CODE SEG 


9 


SIZE - 


179 


BYTES 






CODE SEG 


10 


SIZE - 


% 


BYTES 






CODE SEG 


n 


SIZE - 


BYTES 






CODE SEG 


12 


SIZE - 


8 


BYTES 






CODE SEG 


\l 


SIZE - 


77 


BYTES 






CODE SEG 


SIZE - 


16 


BYTES 






CUMULATIVE CODE 


SEG 


SIZE - 


"987 


BYTES 








LARGEST CODE 


SEGMENT - 


229 


BYTES 






CODE DICTIONARY - 


150 


BYTES 


** MINIMUM CODE SPACE REQUIRED TO 


RUN - 


379 


BYTES ** 



Figure 1-2. Output from MAP Compiler-Directing Option 

ANALYZING A STACK OVERFLOW PROGRAM ABORT 

Figure 1-3, an RPG source program, is included to illustrate the STACK OVERFLOW program abort. 
Figure 1-4 shows the SUBROUTINE STACK information generated from the analysis of the dump file 
after this abort. Note that the segment/displacement values are repetitions. This signifies that the pro- 
gram is looping as it keeps trying to perform a subroutine that is already nested. 

By comparing the segment and displacement values with those generated in the XMAP information, 
and then comparing the associated paragraphs with the LOGIC information, the RPG source state- 
ments that caused the STACK OVERFLOW program abort to occur can be identified. 



00100H 








00200F 1 N 


IPE 


[ 1800 


90 


003001 IN 

ooilooi 


NS 


01 










OO5OOC 






EXSR MAIN 


OO6OOCSR 




MAIN 


BEGSR 


00700CSR 
OO60OCSR 






EXSR OTHER 






ENDSR 


OO9OOCSR 




OTHER 


BEGSR 


01000CSR 






EXSR MAIN 


01100CSR 






ENDSR 


* 1 — 


— *— 


—2 


-* 3 *— 



DISK 



U 
1 90 DUMMY 



Figure 1-3. Source Program for STACK OVERFLOW Program Abort 



1152055 



1-5 



B 1000 Systems Memory Dump Analysis 
Functional Description Manual 
RPG Program Memory Dump 



*** SUBROUTINE STACK *** 






@000A3A@: 2618 :STACK BASE 






60006700: 2928 : STACK TOP 






>V** SUBROUTINE STACK OVERFLOW 


it** 




STACK 






ADDRESS 


SEGMENT 


DISPLACEMENT 


§000A3A@ 


10 


25 


@000A59@ 


12 


25 -+ 


§000A78@ 


12 


56 ! 


(soooAqvia 


1? 


2^ ! 


@000AB6§ 


12 


56 i 


§000AD5@ 


12 


25 +< 


eOOOAFA® 


12 


56 I 


@000B13@ 


12 


25 I 


§000632® 


12 


56 ! 


@000B51@ 


12 


25 -+ 



These 

stack 

entries 

repeat 

the same 

displacement 

address. 



Figure 1-4. SUBROUTINE STACK from STACK OVERFLOW Abort 
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